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BETTSHOW 

As fast year, I sperit some time wandering 
around the BfTT Show which took place at the 
Barbican Exhibition Centre in London from ISth 
to ISth January (indeed, Beebug also had a 
stand at ths show gmng us the opportunity to 
meet and talk vw‘f/i many educatkynal users). 

Olvera//, /f was my impression that the 
proportion of the show occupied by Acorn and 
companies associated with Acorn, such as 
ourselves, was much the same as last year 
(when I was somewhat critical of Acorn). 
However, I thought that there was a different 
feel to this part of the show, and that was one 
of much greater substance and maturity. 

There is now a substantial rar^e of software for 
the Archimedes, much of which is of interest to 
educational users (and to home users as well). 
There are still areas of weakness, arKi ample 
room for the devebpment of further products, 
but in many application areas users now have a 
choice of at least three or four part ages of 
quality, and in many cases app//cafrans are now 
into a second release, with the consequent bug 
fixing and rehnement of the product which this 
implies. 

Acorn staff with whom I talked were quietly 
confident that the future for the Archimedes 
range is now assured, and that with sales of 
over W0,000 a critical mass in its further 
development has now been achieved. 

RISC USER MAGAZINE DISCS 

The Rise User magazine discs continue to prove 
very popular (a significant proportion of our 
readers purchase this regt;/ar?y). It is worth 
repeating that not only do we endeavour to pack 
each monthly disc wrth additional bonus items, 
but that much technical effort is put into 
ensuring that all the software Is tested and 
ufpdatecrfo make each disc as robust and reliable 


as possible. In some cases, we substantially 
rewrite sections of^ograms to ensure that they 
perform as we think they should. 

The menu system co/7 famed on each disc 
proWdes general information about each 
program or application on the disc, and many 
applications include a Help or ReadMe fife 
(particularly in the case of bonus Items) with 
further information. We do urge readers fo 
make full use of the information provided In 
order to make the rrmt of the software, and to 
ensure that ait the requirements for ruryning an 
application are known at the outset 

CONTRIBUTIONS 

We are always keen to publish contributions 
from RISC User readers, Articies and prograrrys 
(either for the magazine or for the magazine 
d'sc) are always welcome, but do try fo make 
sure that you conform to dye style and standard 
of other items in the magazine. 

Hints and Tips also form a very vital and valued 
part of the magazine, and your contributions 
here wifi be particularly apprec/afed. Lastly, your 
letters, with comments or queries on any matter 
relatiryg to RISC User and the Archim^es, will 
often he of interest to others, and the best are 
featured in our Postbag and Technical 
Queries pages (Indeed some of our articles 
come about because of feedbaeJt from readers). 

Do remember fbaf we PAY for ail articles and 
programs published in the magazine, or on the 
magazine disc, and for hints and tips. We bepe 
fo bear from you soon. 

ARCSCAN HI 

ArcScan ill, the multi-tasking version of our 
compufer/sed index system is proving very 
popular (see elsewhere hr details). If any reader 
has developed other indexes for use with Arcscan 
then we wwfcl be interested to hear from them. 
MM 
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1 Ukr I IpliJLIlhll^^ iu-j. rkii la a IrUlLLpE^llirlJ^LVir LfU^Jfs 

whidi all Lbe n^quinsineiits of data storage and 
pn'iceiiHing by cmripuier, using [lie popular BBC Basic 
programniing: language for the cjcamples. It is aimed 
al anybody intcrc^cd in File Handling and 
Databases, whether beginiKrs or niore advanced 
ut^en^. and will appeal lo all u>ho want to leana more 
of thi^ imponant sutigect. 

The book starts with an inlrodnctioav lo ihe 
rudiments of file handling, and in the foUowing 
chapters, develops ait in-depth look at the diiferent 
types of flies serial files, iiidesied files, direct 
access fttes, and searching and wining. \ separate 
chapter Is devoted lo hierarchical and rcEatkmal 
database design, and the book concludes with 
practical advice on deivloping file handtinp programs. 

The asHociateci disc (£4,75) ctmLaiiiE coinpleie 
working programs based on the routines described in 
the book and; a copy of Filer, a Eull-fcaturc Database 
program. 


mArcOne 


Desktop PC Disc Reader and 
Badtground Text Printer 

plus; 


• Stieky BackDrop — pliwes icons aEiyi^here on lEv 
ck.sktoi5. 

• AppBcstiDii Shell Gmcralnr for Crtatiltg 
ap^idU™ dircctOfi»i sprites and [Run filta. 

• Wimp t-'ranl End fbr (he Basic Editor. 

• Wnidid^ Anti-Viru* — protcci yewr hard and 
floppy djBcs ftoni vinisca. 

• Keystrip GcDernTar ;Taoih 9' arwl 24- pin 

pritiitr vcrutons). 

• Bnicode — a Elc ennyptkm dlililv 

• CMOS WAM Maaoji^ 

• tlvatloa Clip^nrt — tom Ifcrhi^’s tuglily successful ITTP package Ovation. 

• Amau — a grtphStallv sUpOrE Sfid enctriainirie gsme. 

9 A sclecijoFi of the hesr MaiCfitHt miuie files. 

• AdTBDGcd Desktop PrcUnlatiuit Credior — screas display with a dMicc 
ofdliffcrccii fades. 

• Palette F'ilcs far Cniinzr Printers. 

• A complete set of ArcSow indcs data 
foe RLSt: User Magazine yidume i. 


A collection of 
7 Original Archimedes 
Games 

ArcOmnibus 


• Amaze — a graphically suficrb slklii^ Mock garde 
wild a differeuec, 

• Cribbaga — arj cnc(JI«il implerncntalidn of the wdt 
knCnvn card game. 

• Moric a COliMirfui 'liMlders and levels' jtame. 

• Ogre^ Lair — a highly enLcrtamkig arcade type- 
game, pravldiug hwies of fUil. 

• Pick a Fair — a culukirful game lestHtg your sViifl; of 
otiscrvaiion and tnemory. 

• BallofuiMaii — hurti the baJloon — a Facraan style 
of game. 

• I>ootinues a Ltsktuip versiun oi' the alaasic game of 
duminocs. 


• Datasheet — Daia E^reseniation IV’tage for creating Rotated gnaphs in 
a ^-ariety of formats few dhplay or printii^. 

■ Calc.iTh — Sdcnrific CaJeuktor, a DcskEnp Implemeniaiiod of the Casio 

FXS70. 

• CharDes — Character DesiRncr for creating new systern fonla. 

• Diary - A mulsi-taskirig Desktop Diary atid cakuihw. 

• Ejn^T — AppJicatijon Handler which aBowz pr-Ograms 10 he edited without 
leaving the D^tOp, 

• PBiaFlnd — FBc-flnd utility which perfewmB hierarchical search far a given 
file-, iipfiJirBl'inii nr dliifiri nry. 

• SclType — FdetVpC. Setter which you can hbc io change the bictype af any 
file by dragging il ta the itxm her. 

• UntKEya — A Desktop hotkeys Utiltty lhai allows single key presitei in 
fhWform a wide range of ftinctians. 

• Monae — Mousc-aperd CunlroHer (Of chilngitig the idOUSe Spsed tlMKly by 
00 an icon. 

• Print — .Mulii-formai Prim ILhilhy — 
ahnwg teat and program files to be 
printtsi [ust by drJigging ihem to the 
icon bar. 

• NotePad. — A Utsktnp Moiepad 
application which priA'ides for up to 
eight pagieg af jiuttinga 

• D^tbin Desktop Dustbin which 
siia on the icon bar and aEcwa fikg ta 
be dcktftd by simply dragging them to 
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PORTABLE ARC 

Acom is to produce a portable Archimedes, 
which will probably appear during the 
latter part of this year. Acorn has not 
released any details at all, but it seems 
certain that the portable will be a high 
speciilcation professional computer, and not 
a budget model. It is rumoured that the 
machine will have an AEM3 processor as 
standard, a high-resolution film-retardant 
LCD monochrome screen and a built-in 
trackerbalL A full colour version is likely to 
follow some time during 1992. We must 
stress, however, that none of these details 
have been confirmed by Acom. 

SOFTWARE DEVELOPMENT 
ENVIRONMENT 

Delegates from 30 companies attended a 
seminar held by Acorn on software 
development in C for RISC OS. The 
delegates were chosen to be representative 
of the range of companies registered with 
Acorn as ISVe (Independent Software 
Vendors) and IHVs (Independent Hardware 
Vendors) who develop and market products 
for Acorn's RISC OS hardware platforms. 
During the course of the day, a presentation 
was made of an integrated SDE (Software 
Development Environment) for RISC OS 
that is currently under development at 
Acorn. Acom plans to release C and ARM 
Assembler products in the latter half of 
1991 which incorporate this environment. 
Acorn will be providing an upgrade 
mechanism for existing owners of Acorn's 
current C and Assembler products, and 
details of this will be announced at product 
launch. Details of all Acorn products can be 
obtained from Acorn Computers Ltd., 
Fulboum Road, Cherry Hinton, Cambridge 
CBl 4JN, tel. (0223) 245200. 

EXPANDED VISION 

Wild Vision has produced an expansion box 
which will allow standard Archimedes 
expansion cards to be used with the A3(X30, 
The box plugs into the rear expansion port, 
and accepts 2 full-width or 3 half-width 
cards. It has an external 12v power supply, 
and protection circuitry to prevent any 
damage to the computer from external 
supplies. The A3000 Expansion Box costs 
£159.85 inc. VAT, and Wild Vision is making 
a special introductory offer of the box 


together with its Hawk V9 colour digitiser 
for £458.85. For further details, contact 
Wild Vision at 15 Witney Way, Boldon 
Business Park, Boldon Colliery, Tyne & 
Wear NE35 9PE, tel. 091-519 1455. 

COLOUR SCANNER FROM BEEBUG 

BEEBUG is about to release a colour 
scanner package for the Archimedes and 
A3000 based around the popular Sharp JX- 
100 scanner. The unit can scan an image of 
up to 160x100mm in 16 million colours. The 
supplied software converts this to a 256- 
colour RISC OS sprite that can be 
incorporated into DTP documents etc. The 
scanner package, which will be available in 
mid-March, consists of the JX-100 itself, a 
half-width interface card, disc-based 
software and a comprehensive user guide. 
An A3 000 version will also be available 
which houses the interface card in an 
external metal case. The complete package 
will cost £665.85 inc. VAT for the 
Archimedes model, and £677.35 inc. VAT for 
the A3000 version. 

MIDNIGHT TRACER 

Midnight Graphics has released 7>acer, a 
software package which enables you to 
convert sprite files into Draw format. Both 
colour and monochrome images can be 
processed, and the result is a fully editable 
object oriented file which can be 
manipulated easily within Draw. The 
package is particularly useful with 
scanners, digitisers, and other devices 
which produce bit-image pictures. TVacer 
costs £59.95 inc. VAT, and is available from 
Midnight Graphics, 5 Victoria Lane, 
Whitefield, Manchester M25 6AL, tel. 061- 
766 8423. 

VIRTUALLY ARMLESS 

At the time of writing, 30 MHk ARM3 chips 
are in extremely short supply. It appears 
that VLSI is unable at present to 
manufacture the chips in the quantities 
needed. As a result, supplies of both the 
A540 and the ARM3 upgrades offered by 
various companies are being held up. 

DTP FOR EDUCATION 

Desktop Folio is a new package from ESM 
which has been designed to provide DTP 
and word processing facilities for 7-year- 
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SCSI HARD DISC 
DRIVES AND 
INTERFACES 
FOR THE A3000 


• From Only £398 

• Fast drives in a wide range of capacities 

• Quality mechanisms (Seagate, Rod i me, etc.) 

• Metal case with power supply 

• Fully screened SCSI connectors and cable 

• Rasily daisy-chained to provide multiple drives 


Bfc^bug have launched a full i-ange of SCSI hard disc drives for the 
A31100 with capacities from 20Mbyle to 33SMbyte. t hese are all 
half height quality drive mechanisms housed in an atli-activc case 
with an internal switch-mode power supply. Included in the price is 
a high quality screened SCSI cable and an S bit SCSI interface, 
which fits neatly inside the A3000 mtxlule slot. This is supplied 
with full fitting instructions and may be fitted in minutes. No 
soldering or specialist skills are necessary. 

A nu mber of drives may be daisy-chained together to give in¬ 
creased capacity. All drives are supplied with through connectors 
and the appropriate cables, but units in the middle of the chain re¬ 
quire a set of terminating resistors to be removed. We can supply 
the drives with these already removed. See oppfTsite for ordering 
details. 


SCSI HARD DRIVES 
[NCLUDING A^.n00 iN' ERF ACE 


Stock code 

Capuciitf 

Price (ex. VA T) 

522£) 

20JVlbyte 

£39H.m 

5221 

49Mbyte 

£498. DO 

5222 

SGMbyte 

£598. LX) 

5224 

110Mbyte 

£798.11) 

5223 

l83Mbyle 

£898. LX) 

5225 

338Mbyte 

ni98.m 


Carriage is £8,00 per drive. Add 10 to stock code 
for drives without terminators (e.g 5220 becomes 
5230). Drives are available withfiut interface - 
deduct £99. 


ARMS PROCESSOR CARD 


• Massive speed increase 

• Riseware control software 

• Comprehensive u.ser guide 
■ Compact design using latest 

surface mount technology 
m Compalible with all software 

The ARM3 micro-proccssof is [he latest in the series of Acom RISC Machine reduced 
instruction set pmciLssors. IL is the micro-processor Gtied a.s standard to Aetjm^S new 
flagship - the 54t). 

This new card from Beebug allows a super-fast ARM,.3 processor running at 32. MMz to he Btled to your Archimedes StXJ Or 400 
series computer. The highly avnpact dreuit Ixwjnd measure; just 35 by mni (approx) and ct>niaLns Hie Latesl surface mounted 
ARM3 prt'jcessxjr logcther wilh a clock ijenerator cincuil. 

The ARM3 Ciind ijs insi-irted in place of the existing ARM2 processor and provides a four-fold jncr^ase 1ti prf>cefiS£>r clock, speed 
along with a 4Kbyte cache which serves to isolate the fast processor from the relatively slow RAM. Average speed increases of 3 to 
5 times are typical, and unlike speed enhancerssuch as floating piint co-processois., (lie ARM3 Card itnproves performance of all 
software. Users, of the PC bmulalor will especially benefit from the increased execution speed, 

Tlic ARM3 Card is supplied with disc-ba.sed software to control the cache operation, both from the Desktop and via .star 
cornniands. The comprehensive iiE«£r guide not only covers the control of the ARM3 card al all levels, but also conEatns details of 
differences between ihe xARM2 and ARMS, and a section explaining the lhet>ry of cache systems. 

NTnie.' Vlir £Ei?dJU^ AKjVU bt fitted i?y iin ykurn fcpfra-vd ctwrfwnfnf Jew/ ienitce centre, its die existing ARM Z dtip Jms iaie femnEMi Viis indtudEs rferfiyg nnd man^ 

nmjor AcfWTf (hders- 'i 7uf Wojibwjj ARM3 k jdl’ tite A300(}, ns die ARMZ processor in dlk ftineiuite k .^idered direcRif in ihe drcitii hotird. 


Stitck cade: 0134 


i ' 

WIT + £.5..5fJ CaTTiage) 
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Bccbiig Ltd., 117 Hatricld Koad, St Albans, Herts, ALl 4JS, Please add VAT at 1.3%. This advert was 
Tel. 0727 40303 Fax. 0727 S60263 produoxl entirely with OmHm DTP 
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olds and upwards. Developed from the 
original BBC Folio, it operates at two 
levels: Simple Screen Folio provides an 
easy-to-use introduction to DTP for younger 
children, while Desktop Folio offers more 
versatile facilities which ESM claims will 
cater for all school DTP and word 
processing requirements. Desktop Folio 
costs £103,50 inc. VAT for a single copy, and 
site licences are available for multiple 
users. Further details can be obtained from 
ESM, Abbey gate House, East Road, 
Cambridge CBl IDB, tel. (0^5) 63441. 

FOREIGN LANGUAGE FONTS 

Outline fonts for Bengali and Punjabi 
characters are now available from the 
Hampshire Microtechnology Centre. The 
fonts were developed primarily for use 
within Hampshire schools, but have been 
made available in order to meet similar 
needs in other areas. Each font comes on a 
separate disc, together with sample Draw 
and Poster files and a keyboard overlay. 
The keyboard layout generally corresponds 
to that used by BBC Folio, as it was felt 
that many users will already be accustomed 
to this layout. Each font costs £20.00 for a 
site licence, and discounts are available for 
area licences. The Hampshire 
Microtechnology Centre is at Connaught 
Lane, Paulsgrove, Portsmouth P06 4SJ, tel. 
(0705) 378266, For further details of the 
fonts, contact Martyn Wilson, Inspector for 
Technology (IT), on (0703) 715217. 

IMAGE CONVERSION 

X_Iinagef from Foster Findlay Associates, 
converts Archimedes sprite files into TIFF 
and other formats widely used on PC and 
other computer systems. With the Arc being 
increasingly used for the generation of high 
quality images, the facility to export these 
to other systems should prove very useful. 
X_lmage is available at a nominal cost of 
£10.00 from Foster Findlay Associates, 148 
West Road, Newcastle upon Tyne, NE4 
9QB, tel. 091-273 1111. 

RISCBASIC EXTENSIONS 

Silicon Vision has produced a new Desktop 
Developers Environment (DDE) for its 
RiscBASIC compiler, which will allow Basic 
source programs created in Edit to be 


compiled simply by dragging them onto the 
RiscBASIC icon, with syntax errors being 
highlighted in the Edit window^ RiscBASIC 
itself is now being supplied as version 2.06; 
registered users may upgrade free of 
charge, or may upgrade to V2.06 with the 
DDE for £50.00 inc. VAT. Silicon Vision is at 
Signal House, Lyon Road, Harrow, 
Middlesex HAl 2AG, tel. 081-861 2173, 

MISSING LINK 

The Missing Link (TML) is a new high 
speed data link from D.R, Computer 
Products, which has been designed to 
transfer data between two Archimedes. The 
link consists of a card which plugs into the 
Eoonet socket (it does not use a podule slot). 
Any two machines fitted with link cards can 
be connected by a cable up to 10 metres 
long (3 kilometres with a fibre optic cable), 
and data transmission takes place at up to 
10 million bits per second. A Desktop File 
Transfer Utility is provided, and typical 
transfer speeds using this are 40K" 
120Kbytes/sec, The price of the card is 
£74.95 inc, VAT, and further details can be 
obtained from D,R. Computer Products, 
Unit 20-21 Enterprise House, 44-46 Tferrace 
Road, Walton-on-Thames KT12 2SD, tel. 
(0932) 240432/566435. 

ALL IS REVEALED 

Revelation is a new product from Longman 
Logotron. Developed at Homer ton College, 
Cambridge, it is an advanced art package 
designed specifically for children. Its range 
of colour manipulation facilities, including 
washing and blending, make it particularly 
useful for processing images taken from 
other sources, e.g. digitisers and scanners* 
All the other features you would expect 
thorn an art package are present, plus new 
facilities such as a set of measurement tools 
which allow the user to measure angles, 
distances and areas within a picture, thus 
making it useful for maths and science 
applications. Claimed to be very flexible, 
user-frieiidly and useful right across the 
curriculum. Revelation costs £87,40 inc. 
VAT (with a limited introductory offer of 
£62.10 until the end of March). Contact 
Longman Logotron for further details at 
Dales Brewery, Gwydir Street, Cambridge 
CBl 2LJ, teL (0223) 323656. 
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Desktop Zoom 


Magnify your Desktop with this short appUcet/on from Mike ironmonger 


T he Magnifier application supplied on 
Applications disc 2 lets you look at an 
enlarged image of a small part of the 
Desktop. Desktop Zoom on the other hand 
will give a full screen enlargement of the 
Desktop at up to 1000 times magnification, 
where one pixel takes up more than the 
whole screen. It is mouse controlled, and 
you can zoom in and out, and pan across 
the whole area by moving the mouse in 
any direction. 

The effect is very dramatic, and may 
even have some use! It is very handy for 
seeing at a glance the way in which 
application sprites have been drawn. 
Moreover it may be useful in certain 
teaching situations where it is necessary 
to view a monitor from a distance. 



Zooming in and out Is sasy 


SETTING UP THE APPLICATION 

To install Desktop Zoom on your 
machine you will need to create a 
directory called !Zoom, and save within it 
three files with the following names: 

1. !Run 

2. IRunlmage 

3. I Sprites 

IRun 

The contents of this short file are given in 
listing 1 * This file must be of type Obey. To 
create it, just use Edit, select Create New 
Obey file from the main menu, and type in 
the listing. 


ISprites 

This is a standard sprite file. The easiest 
way to obtain an appropriate sprite is to 
“steaP the one used in the iMagnifier 
application on Acorn’s Applications disc 2. 
To do this, hold down the Shift key, and 
double-click on the IMagnifier application, 
so revealing the contents of its directoiy. 
Then load the ISpritee file from this 
directory into Paint, and rename the 
sprite !Zoom (using Paint's menu). Then 
save the sprite file (keeping the filename 
ISprites) to the IZoom directory. 

IRunlmage 

This is the Basic program given in listing 2. 
First enter Basic by pressing FI 2 from the 
Desktop, and then typing: 

Basic 

Type in listing 2 and save it to the IZoom 
directory with the name IRunlmage. 

USING THE PROGRAM 

Now get back into the Desktop, and 
double-click on IZoom. This will install the 
application on the icon bar. Clicking Menu 
from here shows just one entry “QuiP. To 
make the zoom facility operate, click with 
Select over the icon on the icon bar, and 
the process will begin. Each further click 
on Adjust will increase the magnification, 
while each click on Select will reduce it. 
Moving the pointer around pans the view. 
To get back to normal, just click with 
Menu (regardless of where the pointer is 
positioned). 

Listing 1 

I ERun file for S^ooin 
WiiripElot -niiri IGK -max 16K 
Run <0bey$Dir>.ERunlmage 

Listing 2 

IG REM >lRunImaga 

20 REM Program Full screen, zoomer 

30 REM Version A 1.00 

^0 REM Author Mike Ironmonger 

50 REH RISC User March 1991 

60 REH Program Subject To Copyright 

10 : 

80 ON ERROR PROCerror( ERR,REPORTS I:GO 
TOllO 
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Desktop Zoom 


90 PROClnlt 
100 : 

no REPEAT 

120 EYS'^Wimp_Poll^ £133,blocks TO A% 

130 CASE A% OF 

no WHEN 6: PROCinouse_click(blockl]8) 
150 WHEN 9: quit%=[!block|=0| 

160 WHEN 17,13; quit%=(block%116=0} 

170 ENDCASE 
130 UNTIL qiilt% 

190 SYS“Wimp_CloseDown" 

200 END 
210 ; 

220 DEFPROCmouse_cllck{Bl) 

230 CASE m OF 

240 WHEN 2 : PROCcreate_menu(Sbiock%} 
250 WHEN m : PROCzooin 
260 ENDCASE 
270 ENDPRCX: 

280 ; 

290 DEFPROCcreate_tnenu (X%) 

300 $menu?!="ZciO[ti" 

310 1 12=470207 :rtienul! 16=100 

320 iriienu^ 120=^4 :nii«nun 24=0 
330 menull28=480:menul!32=0 
340 menul136=4 7000029 
350 $(menu%+40)="Quit" 

360 SYS"Wi]np_CreateMenu",, rnenij%, X%-7D, 
140 

370 ENDPROC 
380 ; 

390 DEFPROCzoon 

400 SYS"OS_Rea<iHodeVariabie%NOOE,7 TO 
;,reql 

410 req%+=100 

420 S¥S"XOS_ModiuIe“,6, ,,req% TO ,,spr% 
;F% 

430 IF F%AND1 ERROR l,^Can^t claim cno 
ugh memcry for the zoomn 
440 !sprl=req%:£pr%I4=0 
450 spr%ia=16:3p]:%112=16 
460 : 

470 $cw%-1280:3Ch%=1024 
480 IF MODE=16 OR MODE=17 OR MODE=24 3 
cw|=2112 

490 SYS'^OS^SpriteOp", £ 110, spr%, "screen 
scw%-l,sch%-l 

500 scale!18=scw%:scale!3I2=sch! 

510 : 

520 OK%=0 ;oy!=0:niag=2 ;oinag=0 
530 PROCwait 
540 ; 

550 REPEAT 
560 PROCiiKJve 

570 IF NOT quit! PROCplot 
500 UNTIL quit! 

590 SYS"0S_Sprite0p",4l22,spr%,"screen" 


600 SYS'OS_Module",7,,spr! 

610 SYS"XOS_ChangeDysnamicArea", n-req! 

620 quit%=FALSE 

630 PROCwait 

640 ENDPROC 

650 : 

660 DEFPHOCmove 
670 REPEAT 
680 MOOSE 
690 CASE b% OF 

700 WHEN 1 : mag+=mg/20nF mag>i000 
mag=l000 

710 WHEN 2 \ quit%=TRDE 
720 WHEN 4 : mag-=mag/20:IF mag<l ma 
g=l 

730 ENDCASE 

740 UNTIL x%<>ox% OR y%ooy! OR magoo 
mag OB quit! 

750 : 

760 K%=s ew !/2 ''Tnag: w%^s cw% * mag 

770 IF x%>Q x!=D 

780 IF x!+w!<scw%+l x%=scw!+l“w! 

790 y!=s ch! /2 “y !*mag:hl=sch!* mag 
300 IF y%>0 y%=0 

310 IF y%+h%<sch|+3 y!=sch!+3-h| 

820 ENDPROC 
830 : 

840 DEFPROCplot 

850 oxl=Kl;oy!=y%:omag=mag 

860 !3cale!=w!:scale!l4=h% 

870 SYS"OS_SpriteOp",4134,sprl,"screen 
",K%,y%,,scalel 
880 ENDPROC 
890 : 

900 DEFPROCwait 
910 REPEAT 
920 MOUSE 
930 UNTIL b!=0 
940 ENDPROC 
950 : 

960 DEFPROCerror(!block!,S{bloGk!+4 )) 
970 S¥S"Wimp_Repcirt Err or", block!, 1, "Zo 
om" 

980 ENDPROC 
990 : 

1000 DEFPROCinit 

1010 SYS“Wimp_Initialise",200,£4B534154 
,"Zoom" 

1020 DIM block! 99,scale! 15,menu! 99 
1030 quit%=FALSE 
1040 r 

1050 lblock!=-nbiock!!4=0 
1060 block!Ee=Diblock!312=68 
1070 block!!16=63:block% 3 20=4300A 
1080 $(block!+24)="3Zoom” 

1090 SYS"Wimp_CreateIcon",,block! 

1100 ENDPROC 
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ArcScan HI 

A new muiti-tasking version of Arcscan, the customisable magazine database 


New features for ArcScan ni 

• now includes subject and function index to Acorn’s 
ANSI-C manual (Release 3) 

• provides flexible keyboard search on any entry 

• improved search logic - choice of 3 logical operators; 
OR, AND and NOT 

• features dynamic memory management, returning 
unused memory to the Wimp 

• uses dedicated ARM code routines enabling rapid 
information retrieval 

• finds are displayed in a fast saolling Wimp window 
allowing you to browse through all entries retrieved. 

• fiilly user customisable allowing other databases to be 
automatically incorporated in the control panel display 

• a new detailed manual and extensive on-saeen help 





tw 3 II n 


Searching is almost instantaneous 


ArcScan ni contains the Following Databases; 

» EtISC User Volumes 1, 2 arid 3 

• BEEBUG Volumes 1^8 

The Indexes to the following major Archimedes manuals: 

■ Basic User Guide (Arthur) 

• Programmers Reference Manual (Arthur) 

■ RISC OS User Guide 

• RISC OS Basic Manual 

• RISC OS Programmer's Reference Manual 

• ANSI C Manual (Reiea^ 3) 


The on-screen help in action 

It is simple to perform a search: 

U If you need to know about Obey Files, enter the words "obey*, "files" and dick on the AND logic All finds in RISC User 
will be instantly displayed. You can now call up the Acom Manuals indexes and repeat the search to get further 
referenccs- 

2. To find the SWl name for SWT &400D4, select the new Programmers Reference Manual from the menu, enter "SWI 
&400D4'", and the answer appears, complete with page references. 


I---------------------1 

1 AjrcScaa IH Disc + Manual £14.95 members (X1S.95 non'members) Stock Code PAS3 j 

I ArcScan III Upgrade (from ArcScan 0) £4.75 members (£7.95 non-metnbers) Stock Code PAU3 | 

I Please add 60p p&p- For upgrade, please send the old AreScaD 11 disc or label. | 

I When ordering please quote your name and membership number. | 

I--------------1 


BEEBUQ Ltd^ 117 Band, St Albans. Herts ALl 4dS. Telephoru (0727} 40203 Fax (0727} fi6026J 
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Magpie _ 

Information Organiser from Longman Logotron 


Reviewed by Mark K, Sealey 


WHAT IS MAGPIE 

Magpie is an easy to use yet 
relatively sophisticated package which 
presents visual and textual material 
both on screen and optionally as hm'd 
copy. It is intended for use in schools - 
typically for project work - but has 
many other uses* 

For example, anyone needing to 
work interactively with information on 
screen or to compile presentations 
using graphics and text, as well as 
sound, could use Magpie as an 
alternative to Genesis II. 



A copyable utility for “reading" 
material created with the package (but 
not for editing it) allows presentations to 
be freely distributed for use by others who 
do not own Magpie itself. 

Yet the product has potential as a basic 
desktop publisher too; this is chiefly 
because it makes use both of an intuitive 
interface and of the Acorn Outline Fonts. 
In general, its speed of operation, data 
compression techniques and overall feel 
mean that anyone interested in this type 
of software should look seriously at Magpie. 


^tgura f, Potentlaf tnformBtlon sources lor a 
Magpie file 

by Longman Logotron onto it. Magpie only 
works with RISC OS: and Acorn^s useful 
Sysmerge utility for updating !System to 
the latest versions of the modules is 
included with the package* 

USING MAGPIE 

Once Magpie is installed on the icon 
bar (the application is fully multi-tasking) 
work can begin - either by dragging a 
Magpie file onto the main icon or clicking 
Menu over it to create a new folder. 


THE PACKAGE ITSELF 

Magpie comes on two discs (program 
and examples) with the usual Logotron- 
style key-disc protection system. This will 
be a disincentive to many users, 
particularly those in small schools who 
cannot afford a site-licence and for whom 
safe storage of “the original disc” may not 
be guaranteed. There is also an excellent 
A4 size 75 page manuaL 

It is advisable to follow the lengthy 
and thorough “getting started” section of 
the documentation. By the time you have 
done so, you will have made a separate 
data disc and copied those IFonts supplied 


The physical model for Magpie is that 
of the ring-binder; it is composed of 
each with one or more pages. Both 
can be moved or new ones added, and a 
page can contain graphics (including 
sprites), arrows and lines for annotating 
the graphics, text, frames and rectangles 
(see fig.l). Additionally these pages can 
include sound samples and music 
(IMaestro files). What is more, they can be 
linked so that the user can follow a theme 
or work interactively through a 
presentation. More of this linking later. 

Modelling all of this on screen in a 
consistent and accessible way was always 
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Magpie: Information Organiser from Longman Logotron 


going to be the most challenging task for 
Magpie’s designers and programmers. As 
well as providing a main text-bearing 
menu box for overall page operations^ they 
have opted for a relatively standard, 
Impression-like, style of plinthed dialogue 
boxes. 

The purpose of some of the icons, to be 
truthful, is not as self-evident as it might 
be, A colour crib-card with the product 
(showing icon functions and all text 
equivalents, perhaps in menu-map 
context) might have been helpful* 
Nevertheless, the tutorial takes you easily 
through the process of creating a Magpie 
“binder” and dividing it into sections of 
your own choice. 



PigurB 2. Magpie bimSer contents page 

Imagine the theme was architecture, 
then the “sections” might be: building 
techniques, materials, famous architects 
etc. The pages might then contain 
annotated examples appropriate to the 
section: biographies with scanned 
portraits, text on stones or line-art of 
construction methods* A section can, and 
usually will, contain several pages. 

Although hoth pages and sections can 
be added as aflerthoughts, some planning 
is advisable. You are free to place all 
scanned and sampled material as well as 
text and graphics files in a disc directory 
of your own choice. 


When you begin to lay all this out, you 
will be asked if you want an A4 or A5 size 
folder, although the default (and preferred) 
size is that of the screen itself; at this 
stage you can also change parameters 
relating to colour* When it comes to 
graphics (from Draw, say), the aspect ratio 
can be preserved during rescaling. This is 
only one of many touches that add to the 
appeal of the product. 

MENUS AND ICONS 

Although you are led through the set¬ 
up stage with whichever of Magpie’s 
menus are necessary, most of them are in 
fact context-sensitive or can be popped up 
when required (mouse Menu button)* 
Indeed, you quickly become used to finding 
your way about the package. Chief among 
the menus is the main page toolbox. This 
has eight icons to edit a page, and permits 
sizing and placing of objects, text-entry 
and editing, styles and formats of display, 
linking and browsing etc. 

Again, the purpose of all these icons is 
not as memorable as it might be. There 
are few to learn, however, and the 
reference section of the manual is a model 
of clarity, so this should not be seen as a 
major drawback. The relevant icon 
appears in the wide left-hand margin in 
case you should forget* 

LINKING PAGES 

It may well be at this point that you 
wish to enable later users to “turn” pages 
within the binder - by means of "buttons”. 
This is easier to do than to explain but 
basically allows you to consult pages in 
various sequences, extract objects from 
the presentation for use in your own 
applications and hide/reveal or “play” 
them as appropriate* 

For instance, the designer of the 
presentation may want to simplify it by 
introducing the illustrations only after 
chunks of text have been read or by 
directing the reader to a section of the 
binder where all the illustrations are 
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Magpie: information Organiser from Longman Logotron 


grouped. Later in the presentation it may 
be necessary to visit the illustrations 
again, this time in a historical sequence 
arranged according to time. But now the 
routing could well be entirely different. 


IRIii 
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Figure 3. Fife types directly usable by Magpfe 


Such pages will contain either a 
graphic or text prompt inviting the user to 
click with the mouse and/or use specified 
keypresses to follow this routing, which 
needs to be quite sophisticated; in some 
respects it may turn out to be not very far 
removed from teletext page routing 
techniques. 

Once again, use of the dialogue boxes 
necessary to achieve all of this is logical 
and straightforward. For example, the 
plain “button icon” is selected and a 
button to “turn the page" is placed exactly 
where you want it on the screen, typically 
at the bottom right. This placing is 
achieved by exactly the same mechanism 
used to position and scale any other 
Magpie object. 

The button's characteristics can be 
altered at will: it can be transparent, one 
of several predefined graphics (an open 
book for pages backwards and forwards or 
a selection of arrows) and may or may not 
set a “tag” for the user to skip straight 
back to this same starting point in the 
binder when the page pointed to by the 
button has been read. 


Quite intricate and lengthy interactive 
learning sequences, too, can be built up 
very easily by using this feature of 
Magpie. Of course, all the data relating 
not only to the material itself but how it 
behaves in this latter respect is saved in 
one file somewhat like a much scaled- 
down and static interactive video disc. 

SOME PROS AND CONS 

A data compression technique is 
employed so that a full page with perhaps 
two graphics and three or four boxes of 
text, annotation and links occupies no more 
than 12K, which could actually well be less 
than an original sprite contained in it. 

The downside is that a screen may 
take several seconds to appear in full, and 
there is no overall indication whereabouts 
in the hinder you are at any one time, 
except by referring to the window title bar. 
There are other very minor snags in 
editing with Magpie. A text's font cannot 
be changed once the text has been entered 
and displayed; to make up for this, the 
selection of font, leading and sizes is 
amongst the easiest for packages of this 
kind now available for Acorn machines. 

Pages can be printed, singly and in 
sequence, using the RISC OS drivers. Text 
can be searched, imported from other 
applications such as Edit, and all manner 
of alterations to material made very 
easily. 

There are intelligent control key 
equivalents to some of the operations, and 
the relatively shallow menu structure as 
well as total Desktop compatibility make 
Magpie very easy to use. 

MAGPIE READER 

Once you are happy with your pages 
and their contents, you {or someone else) 
will want to use them. This is where 
MagpiRead) the browser supplied with the 
package, comes in. You will discover from 
the manual that you can distribute this 
module vrith your pages (which are thus 
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Magpie: Information Organiser from Longman Logotron 


not entirely stand-alone) provided you 
make no charge. 

Here, althongli it uses eimilar 
conventions to those of the main program, 
passage through and selection of features 
on the pages is direct and self-evident. 
Again, the videodisc analogy springs to 
mind, though things are much simpler, 
easy to use and effective. 

CONCLUSIONS 

Longman Logotron has come up with a 
winner. Unlike some of the more complex 
DTP packages, Magpie has been limited to 
a simple specification with just those 
features anyone wanting to edit pages 
simply would want. There is just the right 
number of ^drop shadow' and frame type 
options; colours are limited to 16 and 
there is no plethora of arrow styles, for 
example, with which to label diagrams; 
most pleasing results can be achieved 
using those provided. 


Longman Logotron has also designed a 
menu/control structure that, while 
perhaps relying too heavily on icons, 
makes good sense and speeds up, rather 
than hinders, what you are trying to do. 

Advanced presentations would be 
better done with Genesis 11. But where 
clear easy to achieve results are needed 
quickly, and full control of the on-screen 
effects is at a premium (for first time 
users and children, maybe), Magpie - at a 
reasonable stand-alone price and with its 
excellent manual - can be thoroughly 
recommended. 

Ptoduct Jlfeppfe 

Supplier Longman Logotron 

Dales Brewery, Gwydfr Street, 
Cambridge C8i 2LJ. 

Tei (0223) 323656 
Price £54,00 (sianct afona) 

rr75.0fJ Ih-imary site Hcence 
C300,00 Secondary site ilcence 

Ail prices errdude VA T and p&p. 


/ VoiceBuilder 

from MJD SOFTWARE, the makers of 

!VoIceBuilder is a new package from MJD Software, offering the user a 
powerful, but easy to use facility for creating new sound VOICE modules. 

Withfn mfnutes, new instruments and effects can be created for use with afi oommerciai 
music packages, or within your own programs. 

Mam features include; 

Selection from wide range of waveforms and envelopes 
Full control over the time domain for attack / looping / release phases 
Separate loop positions for amplitude and pitch envelopes available 
'Ci Sounds instantly available for testing via keyboard or MIDI 
^ Full RISC-OS multitasking - use alongside Maestro, Rhapsody etc. 
Ultra-compact module storage - 8 voice module takes up roughly 13k' 

AVAILABLE NOW FOR ONLY £ 19 . 95+£1 .50 P&P 

MJD SOFTWARE 13 BURNHAM WAY LONDON W13 9YE 






Beebug Public Domain Software - New Release! 


This list includes 7 new discs (★ ) added last month to our public domain library. Further titles will be added in the future. 
We are also offering a Sampler disc with a selection of public domain programs from all areas of interest. 

Uitlike other Public Dcnnain software, our discs contain as near as possible to 800k (and not less than 700k). 

Each disc includes a 'Read Me* file, arxi there are some instructions with the programs. 

It is our policy with our public domain library that the Public Domain discs arc available only to RISC User members 
for £2.99 (postage is 60p for the first disc and 30p for each additional disc). The discs are offer^ as seen, and we cannot 
enter iruo any discussion regarding their contents. 

To order phone (0727) 40303 , Fax (0727) 860263, or write to (quoting your membership number): 

B££BUG« 117 Hatfield Rd, St Albans, Herts ALl <JS. 


DEMOS 

PDlZDisc 

Contains 5 souixl and graphics demos from Hugo Fiennes 
of the Serial Port Ail five are stunning examples of what 
the Arc is capable of. 


GAMES 

PD19 

Contains 10 games programs, Adevnture, Battle, 
Battleships, Connect4,^rts, Fish (Pelmanism), Fruit 
Machine, Golf, I iangman and Impact. 


PD21 Disc A 

Contains three demos. Balls, Balls2 aixl BIA-Tetris. The 
latter is a game as well as a demo. 

PD22 Disc 

Contains three demos. Noah, Chips arxi DcmoOl. 

PD23 Disc A 

Contains four demos. Bounce, Crimbo, ColDemo arxi 
Rotate. 

PD24 DLs. 

Contains three demos. Demo, Gopher arxi Overscan. 
PD25 

Contains four demos, Deskballs, DudsDcmo, Eglntro, arxi 
2-Brother. 

PD 76 Disc A 

Contains three demos. Sister, Wibble and SkullDemo. 


pn7o 

Contains 12 games programs. Invaders, Line Of Five, 
Othello, Pelmanism.Rocks, Rubik Cube, Simon, Sc^itaire, 
Star Trek, Tetris, Tile Trial arxi Yahtzee. 

UnUTlES 

PDTgDL*^^ 

Contains 20 utilities of various types. These are all 
extremely good arxi there is something here no doubt to 
lease everyone. Space does not permit full descriptions 
ut the file list is, IstFile, ASm2, CloseUp, Crypt, Dir, 
Display, Drawlink, Dustbin, Filetypes, FileUtils, Firxi, 
Keys, Loadprogs, MultiPrint, NewBar, NewCodes, 
PDJmpress, PrinterTx, ProgCalc, and Set_Type. 


PD27 Disc * 

Contains two demos, GrannyChow and Wirxiows. 

GRAPHICS 

PD13 Disc 

Contains the ’Projector application that displays 
films created with the Ace Computing Mogul 
package. Six example films are included. 

P018 Disc A 

Contains a program that displays several still 
arxi animated ray traced pictures. 

EDUCATION 

PD14 Disc 

Contains REG, a suite of programs for 
recording student achievement levels in 
schools. Also, included is a way of recording 
attainment with Colton Software's Pipedream. 

ART 

PD15 Disc 

Contains Arctist-** arxi BigM, both 256 colour 
art packages, along with D^ign, a 
symmetrical pattern designer. 

MUSIC 

PDl6 Disc A 

Contains 250 tunes for loading into the music 
package Maestro, with enough variety to suit 
most tastes. 

TRICKS AND NOVELTIES 

PD17 Disc 

Contains a collection of 27 amusing trick and 
novelty programs. Some of them produce the 
weirdest effects! 


ijtisc 

Contains over 4 megabytes of Sprite pictures which can be 
used as dip art to load into DTP or use in your programs. 
The files are naturally in a compressed form and the disc 
contains the file to uncompress them and has instructions. 

Contains over 2 megabytes of Sprite clip art and Draw files 
to load into DTP or use in your programs. The files are 
naturally in a compressed form and the disc contains the 
file to uncompress them arxi has instructions. 


ruI>U^ Domain Sar pier Disc tPDSl) 

This disc contains sample programs from the Beebug Public Domain Software | 

Library. The programs are as follows- 

STradrer • The STracker applkaiion is used to play bade a music file Toccata made 
of real sampled sourxis which are sequerxed to form a corx^lete tune lasting several 
minutes. The quality of this is quite stunrUng, particularly if played through the 
computer's monitor speaker, or a hi-fi system. 

Accounts - This is a home accounts program There are no instruciions included 
with the program but all functioos arc sdeaod from the main menu which is sdf 
explanat^. An exan^le Tile is induded. 

DlscLabel - This is a versatile disc labelling program pModudng professional looking 
labels for 3-5* discs. A Hdp file is induded wish the program. i 

Follow - This is a novdty program that when run puts a pair of beady eyes on the 
desktop that follow the mouse pointer wherever it goes. Eerie! 

Hangman • A well presented arxi implemented version of the old word game of 
Hangriun with an animated finale. 

Muldpiinl • A utility to allow the priming of files by creating a task list of the files to 
prkit ^fore setxiing them to the prirtter. A Hdp file is ifKlud^ within the program. 
Rotate - A fascinating animated demo in which you can alter the effects by pressing 
a few keys on the keyboard. 

STD - A useful utility to search for tdephone STD codes or fiixl a town from its STD 
code. A RcadMe file is irKiuded in the program. 

Wanda - A novdty demo program that infests your desktop screen with a shoal of 
bubble-blowing goldfish! 

— _____ > 


















Hard Disc Archiver 


by J.V. Parker 

he program presented here enables 
yon to back up a hard disc onto a 
number of floppies, and has been designed 
for both ease of use and program 
simplicity* As a result, it can be typed in 
with very little efiFort. The program is not 
multi-tasking, since when writing to or 
reading from disc the CPU has very little 
spare time {try running Usage on 
Applications disc 2 while backing up a disc 
to see what I mean). It doesn't need to be 
an application because it has no sprites or 
resources and runs from the root directory 
of the hard disc. After setting up the 
program initially for your system, it will 
archive the complete hard disc the first 
time it is run, and thereafter will just 
update the files which have a different 
date stamp from those in the archive (i.e. 
the latest versions)* 

One useful feature of the program is 
that archived files are not stored in a 
compressed form, so they can be run from 
the backup discs or just dragged into a 
filer window. 

SETTING UP THE PROGRAM 

PROCinitial sets up the variable 
strings which are used to control the 
cop3ring process. These strings define the 
source and destination paths, and the 
copy options which will be used* The 
source path in line ISO should be tailored 
to suit your drive, e.g. if you have a SCSI 
drive it might read: 

180 hard$=”SCSl::SCSIDisc4*$*" 

The copy options defined in option$ are as 
follows: 

A(ccess) on, 

-Cfonfirm) off, otherwise you'll wear 
your mouse out. 

-D(elete) off or you'll wipe your hard 
disc. 

F(orce) on to ensure that older copies 
on the floppy are overwritten. 


L<ook) on. 

N(ewer) on to ensure only newer files 
are updated. 

-Pfrompt) off - not needed when 
copying from hard to floppy. 

Q(iiick) on so that application 
workspace is used to speed up the 
process. 

R(ecurse) on to copy sub-directories. 

^Sftamp) off. 

(s)^T(ructure) off since you want the 
files as well as the directory stmeture, 

- Vf erbose) off (unless you have all 
night to check the names)* 

These are all documented in the Kfsc 
OS User Guide pages, 202-204 or 208-210 
depending on your version of the Guide. 

If you have a program which writes 
files without date stamps (e.g. a BBC 
program running under !65Ho8t), then 
you will need to change option$ to ignore 
date stamps, i.e* change N to -N. Also, 
files which are written to (e.g* using 
OPEN UP) do not have their date stamps 
updated automatically so if you have a 
directory where this happens on a regular 
basis, you'll have to change the Newer 
option for that as well* In the example set^ 
up shown in the listing, this is done in the 
case of floppy disc 7 (lines 440-470), where 
options is changed before and after 
archiving IViewsheet. 

USING THE ARCHIVER 

The first step is to format and name 
enough discs. The names are BUI to 
BUn* To calculate how many discs will be 
required (i*e* the value of n), you must 
first decide what is to go onto each disc. 
Use the Count option provided by the 
Filer to find the total size of all the files 
in a directory, then add 2K for the 
directory itself and the same for any sub¬ 
directories* If you aim to put a maximum 
of, say, 500K on each floppy, this will 
allow plenty of room for either new 
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programs or revised versions under a new 
name when you come to update your 
archive. 

Having done this, you can then write 
PROCupdate to suit your system. Each 
WIIEN clause refers to the floppy of the 
same number, e,g, in the statement 
following WHEN 1, the parameter passed 
to PROCosc defines the directories to be 
put onto disc BUI (in this ease a single 
directory called I Fonts)* You can place 
more than one directory on any floppy by 
simply making additional calls to 
PROCosc, as in the example for floppy 2* 
However, if a disc is to contain only part of 
a directory (as for disc 6 where only part 
of directory C is copied), then you must 
create directory C on BU5 first, otherwise 
you will get a Slot found” error* 

Bear in mind that if you undertake a 
major restructuring of the organisation of 
your hard disc, you will need to edit 
PROCupdate, but you will not need to re- 
archive anything for which you still have 
the original backup discs. 

The program will not wipe files from 
the floppies which are no longer present 
on the hard disc, so eventually you may 
have to wipe them manually from time to 
time to avoid running out of space. As long 
as a floppy still has the same name, it will 
still work even if you have wiped it clean, 
though the next time it ia used all files 
will be copied* This does have one 
advantage: if you wipe something from 
your hard disc and decide later that you 
want the file after all, it may still exist on 
the backup disc. 


10 REM 

20 REM Prograin 
30 REM Version 
40 EEH Author 


>Archiv8r 

Hard Disc Backup 
A 1.00 
J*V,Parker 


50 REM RISC User March 1991 


60 REM Program Subject to copyright 
70 : 

SO ON ERROR PROCerror:END 


90 FROCinitial 
100 FOR I%"1 TO 30 
110 PROCupdate 
120 NEXT 
130 END 
140 r 

150 DEF FROCinitial 
160 oscli$="" 

170 copy$="Copy" 

180 hard$-" adfs::4.5." 

190 floppy$-" adfs::BD" 

200 disc$=".$." 

210 option$=" A -D F L N -P Q R -S 
~T ~V" 

220 from$="" 

230 EWDPROC 
240 : 

250 DEF PROCosc(fromS) 

2 60 oscli$“Copy $+hard$+f Tom$ +floppy$+S 
TR$I% +dis c$+from$+option$ 

270 OSCLI oscli$ 

280 ENDPROC 
290 : 

300 DEF PROCupdate 
310 CASE r% OF 

320 WHEN 1 : PROCosc("iFonta"} 

330 WHEN 2 : PROCosciSystem"J 
340 P RDCosc("!Telet ext"J 

350 PROCosc("Archive ") 

360 PROCosc("!Utils.1Boot") 

370 PROGosc("'Utils.!Run") 

380 WHEN 3 : PROCosc("Basic") 

390 PROCosc("iBirds") 

400 WHEN 4 : PROCosc("Stars") 

410 WHEN 5 : PROCosc("C.tCstart") 

420 PRCJCosc("C. makefiles") 

430 PROCosc("C * programs") 

440 WHEN 7 : 

450 optioiiS=" A -C -D F L -K -P Q 
R *S -f 

460 P ROCo s c (" 3 Views beet") 

470 options^" A -C -D F L N -P Q 
R «S -T -V" 

4SO ENDCASE 
490 ENDPROC 
500 : 

510 DEF PROCerror 

520 PRINT REPORT?" at line ";ERL'oscli? 
530 EHDPRX 
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The Electronic Font Foundry 
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Watchdog Update 


Nick Smith adds some enhancements to our popular Watchdog Anti-Virus 
appiication. 


atchdog was originally published in 
RISC User Volume 3 Issue 7. Its 
purpose was to protect discs from being 
infected by viruses, by filtering out certain 
operating system calls which involve 
writing to disc. It has proved to be a 
popular application, particularly with the 
spread of public domain discs for the 
Archimedes, and we have now updated 
the original to include additional levels of 
protection. A minor bug has also been 
fixed. 

As originally published. Watchdog 
allowed normal saving and deleting, as 
these operations are often in continual use 
while working with the computer, but 
prevented FileCore_DiscOp calls and also 
the OS_FSControl call used by *Wipe, In 
addition, a facility was provided to *^cleaii" 
a disc, by compacting it as far as possible 
and then wiping the free space to remove 
any hidden viruses. The magazine disc 
version also offered an extra level of 
protection by preventing all write 
operations. 

This extra protection provides the 
main feature of the new version listed 
here {V2.50). It is now possible to specify 
either partial or total protection; choosing 
the latter will prevent viruses from 
performing any operations which will 
write to your disc. A fourth option has also 
been added, which not only prevents 
writing to, but also reading from a disc. 
Thus all disc access is effectively 
prohibited. This can be useful for keeping 
prying eyes away from your files, so if, for 
example, you have confidential 
information on the disc, you can switch 
this option on if you need to leave your 
computer unattended, and be sure that 
nO“One else can read the files in your 
absence. 


AMENDMENTS 

The two listings given below show the 
necessaiy modifications to be made to the 
original listings. Some of the lines are 
replacements for existing lines, while 
others are new lines to be added. Load the 
original IRufilmage program into Basic 
and then type in the lines given in listing 
1. Then save the whole program back as 
tRunlmage, Follow the same procedure 
with MakeWatck. It is essential that the 
hne numbers of the original programs are 
exactly as listed in Volume 3 Issue 7, and 
must not have been re-numbered. 

Before you can use the new Watchdog, 
you must run Make Watch to create a new 
ViatchRM module. You will also need two 
additional sprites in the ISprites file: 
fwatchdogS and !watckdQg4. These should 
be the same as the existing sprites but 
with a different colour light for each level 
of protection, e.g, black for off, yellow for 
partial, orange for total and red for 
read/write. 

USING WATCHDOG 

The application is used in exactly the 
same way as before. When installed on the 
icon bar, the icon will reflect the current 
protection level both by the colour of the 
light and the text below. Pressing Menu 
over the icon will now display the 
following options: None, Partial, Total, 
Read!Write, Clean and Quit. The Clean 
option works as before, except that a small 
bug has been fixed so that discs with no 
bytes of free space can be cleaned without 
crashing. The other options are self- 
explanatory and refer to the protection 
levels described above: None allows all 
disc access, Partial prevents write 
operations apart from saving and deleting, 
Total prevents all write operations, and 
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Read/write prohibits both reading from 
and writing to the disc. 


This month*8 magazine disc contains an 
even more advanced version of Watchdog 
(V3.00), which in addition to the 
enhancements presented here, offers a 
number of extra features. For example, 
with protection set, it is possible to specify 
a pathname which remains unprotected; 
thus you can write to a floppy while still 
protecting your hard disc. 


Listing 1 
10 REM 

20 REM Program 
30 REM Version 
40 
50 
60 
70 
100 
1200 
1205 
1210 
1215 
1220 
1260 
1270 
1280 
1320 
1330 

1340 

1341 

1342 

1343 

1344 

1345 

1371 

1372 

1373 

1374 

1375 
1600 

! 0=0 
1621 
1622 

1623 
! 0-0 

1624 

1625 


>!RiinlBAge 
Anti-Virus utility 
A 2.50 


REM Author Nick Smith 
REM RISC User March 1991 
REM Program Subject to Copyright 

DIM blkl 512:DIM menu% 228 
CASE !blkl OF 

WHEN 0,l/2,3:PROCProtection(!bm) 
WHEN 4:PROCClean 
WHEN 5:finishedl*l 
ENDCASE 

DEF PROCProtection(item%) 
protect%-iteml 
IF iteml-0 THEN 
ENDIF 

IF item%-l THEN 
OSCLI "Lock P" 

$(bufferl+30)-"S!WatchDog3" 
$(bufferl+20)*"Watch XOn" 

ENDIF 

IF item%»2 THEN 
OSCLI "Lock T" 

IF item%-3 THEN 
OSCLI "Lock R" 

$(buffer%+30)-"S!WatchDog4" 
$(buffer%+20)-"Watch R/W" 

ENDIF 

IF protect1-0 item%!0-l ELSE item! 

$ (itemU12)-"None"+CHR$ (0) 
item%«item%+24 

IF protect%-l iteml!0«l ELSE iteral 

iteml!4=0 

item%!8-&7009011 


1626 $(item%+12)-"Partial"+CHR$(0) 

1627 iteml-item%+24 

1628 IF protect%=2 item%!0-l ELSE itemi 
! 0-0 

1629 item%!4-0 

1630 item%!8-47009011 

1631 $(item%+12)-"Total"+CHR$(0) 

1632 item%-iteml+24 

1633 IF protect 1-3 item%!0-l ELSE item% 

!0-0 

1634 itemi!4-0 

1635 itemi!8=47009011 

1636 $(iteml+12)-"Read/write"+CHR$(0) 
1720 SYS "Wirap_CreateMenu",0,menul, (blk 

I!0)-200/2,44*8+32 
1820 $(bufferl+20)-"Watch XOn" 

1830 $(bufferl+30)-"S!WatchDog3" 

2010 OSCLI "Lock p" 

2020 protectl-1 


Listing 2 

10 REM >NakaNatch 

20 REM Program Module source code 

30 REM Author Nick Smith 

40 REM Version A 2.50 

50 REM RISC User March 1991 

60 REM Program Subject to Copyright 
240 EQUS "WatchDog"+CHR$(9)+"2.50 ("+M 
ID$(TIME$,5,11)+") By Nick Smith"+CHR$0: 
ALIGN 

270 FNcommand("Lock",Lock,4010001,Lock 
Syn,LockHlp) 

330 .LockSyn EQUS "Syntax: *Lock [p|t| 
rw)":EQUB 0:ALIGN 

410 LDRB Rl, [RO]:ORR R1,R1,#32 

411 LDRB RO, drives :TEQ Rl,#ASC"p" 

412 MOVEQ R0,#1:TEQ Rl,#ASC"t" 

413 MOVEQ R0,#2:TEQ Rl,#ASC"r" 

414 MOVEQ R0,#3:STRB RO,drives 
680 BIC R0,R0,#4FF:BIC R5,R0,#4300 
730 SWI "XOS_GBPB":BVS exit_clean: SWI 

"OS_ReadEscapeState" 

1061 TEQNE R11,#408:TEQNE Rll,4409 

1062 TEQNE Rll,#40C:TEQNE R11,#40D 
1110 LDRB R12,drives:TEQ R12,#1:BEQ lev 

ell 


1120 TEQ R12,#2:BEQ level2:TEQ R12,#3 
1130 BEQ level3:B routine 
1140 : 

1150 .levell 
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1160 TEQ R11,R10:BNE Isvelljump 

1170 AND R11,K1,#I1111:TEQ Rll,#2 

IISO TEQKE R11,#4:BNE routine:BEQ error 

1190 .levell_jmiip 

1200 TEQ RlI,#fi29:BKE routine 

1210 TEQ R0,#27:BNE routine:EEQ error 

1220 : 

1230 .level2 

1240 TEQ R11,R10:BNE level2_junipl 

1250 AND R11,R1,#11111:TEQ Rll,#2 

1260 TEQNE [U1,#4:BNE routine:BEQ error 

1270 .level2Jumpl 

1280 TEQ R11,#S29:BNE level2_juiii>2 

1290 TEQ R0,#27:TEQNE R0,#24 

1300 TEQNE RO,#25:TEQNE R0,#26 

1310 BEQ error:BNE routine 

1320 . level 2_junp2 

1330 TEQ Rli,i&0D:BNE Ievel2junip3 

1340 TST R0|#&80:BEQ error:BNE routine 

1350 .level2_jump3 

1360 TEQ Rll,#i08:BNE routine:TEQ RO,#0 
1370 TEQNE R0,#1:TEQNE R0J2:TEQNE RO,# 
3 

1380 TEQNE RO,#4:TEQNE RO,#6:TEQNE RO,# 
7 

1390 TEQNE RO,#8:TEQNE RO,#9:TEQNE RO,# 

10 

1400 TEQNE RO,#11:TEQNE R0,#I8 
1410 BEQ error:BNE routine 
1420 : 

1430 .level3 

1440 TEQ R11,R10:BNE lsvel3_jumpl 
1450 AND R11,R1,#11111:TEQ Rll,#2 
1460 TEQNE Rl1,# 4:BNE ro utine:BEQ error 
1470 .level3_juinpl 
1460 TEQ R11,#&29:BNE Ievel3_jump2 
1490 TEQ RO,127:TEQNE R0,#24 
1500 TEQNE RO,#25:TEQNE RO,#26:TEQNE RO 
,#10 

1510 TEQNE R0,#32:BEQ error:BNE routine 
1520 .levels_jmiip2 

1530 TEQ R11,#&0D:ENE Ievel3_jump3:BEQ 
error 

1540 .level3_jumps 

1550 TEQ R11,#&08:BNE Ievel3_junip4 :BEQ 
error 

15 60 .leve13_j ump 4 

1570 TEQ R11,#£09:ENE level3Jump5:BEQ 
error 

1580 .Ievel3_jump5 


1590 TEQ Rll,#&OC:BNB routine:BEQ error 
1600 : 

1610 .error 

1620 BIC R12,R14,#£FC000003 
1630 UOR Rll, [El2,#-4] ;TST Rll,#a«17) 
1640 BEQ gen6rate_error:LDMFD R131,{R10 
-R12I 

1650 ADR RO,errBloclt:ORRS RI5,R14,#{1« 
28) 

1660 : 

1670 .generate_error 
1680 ADR R0,errBlock:M0V Rl,#6 
1690 SWT "OSServiceCall^iADR RO,errBio 
ck 

1700 MOV R9,#l:SWI "OS_CallAVector" 

1710 LDMFD R13!,{R10-R12}:MOVS PC,R14 

1720 .const EQUD &FFF20000 

1730 .filecore EQUD 40540 

1740 .errBlock EQUD i;i03C9 

1750 EQUS "Protected disc”:EQUB 0:ALIGN 

1760 : 

1770 ] 

1160 NEXT passi 
1790 na]Tie$="WatGhRM" 

1800 SYS "OS_File ”, 10, narne$, &FFA,, code% 

, 0 ^ 

IBIO PRINT "'Module Saved as "’naiiie$’" . 

1820 END 
1830 : 

1840 DEF FNcomntand(Gom$,cal 1, flags,synt 
ax,help) 

1S50 [OPT passi 
1860 EQUS com$:EQUB 0:ALIGN 
1870 EQUD call:EQUD flags 
1880 EQUD syntax:EQUD help 
1890 ]:=0 


Skyfall Public Domain 

Ttic Wof ld5 Ingest ArcfUniedes Public Domain 

Skyfall has virtually every bit of PD ever wriiien or 
drawn for the ArcNmodes, well in excess of 300 discs. 
Stracker, Galleries, Colour DigitizaUoris, Applications, 
Games, Ray Traced, DTP Clips and Sprites, Mega 
Samples and the list goes on. All available at between 
12.50 and iil .50 depending on quantity ordered. 

Send a M coin for our demo disc, 
or send an A5 SAE for the printed catalogue. 

Skyfall PD» 93 Jayshaw Avenue, 
Birmingham. b43 SRX. 
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Bases DBMS 


AiBn Wrigley reviews a new programmable database for the Arc. 


B ases DBMS was first shown to the 
public at the BBC Acorn User Show 
last September. There are already, of course* 
a number of databases on the market for the 
Archimedes, some of them multi-tasking* 
and so the first question to ask is: ^'What 
makes Base5 different from the rest?” 

The answer is that Base5 has been 
designed from the outset as a programmable 
database* to be used by software developers 
as a basis for their own database 
applications* rather than a front-end 
database manager with a programming 
language tacked on. A multi-tasking Wimp 
front end has been supplied with the 
database, but the real scope of this package 
lies in the powerful set of Basic procedures 
and functions which will allow any 
competent programmer to design a database 
to his or her own specification. 

THE PACKAGE 

Base5 DBMS comes on a single disc* 
together with a ring-bound manual. The 
package I used for review also had a 
supplementary manual covering the multi¬ 
tasking front end and procedures which 
were not present in the original version, 
though these may be combined into one 
manual in the future. On the disc are a 
multi-tasking database application, 
WimpBasedy together with some sample 
database files including one of English 
monarchs which is used to provide examples 
throughout the tutorial section of the 
manual. Also on the disc are the libraries of 
procedures and functions which form the 
heart of the package* The main library 
contains some 80 procedures and 57 
functions which provide all the file and data 
handling facilities, while separate libraries 
contain procedures for mathematical 
functions* reports* and “relate” files* which 
allow a relational database structure to be 
created* Finally, the disc contains a line 
input module to handle keyboard input* 

Extensions to the system are planned, in 
the form of add-on libraries and utilities. 
For example* the latest developments* which 
should be available by the time you read 
this, are an advanced maths library, and a 


library to process data representing co¬ 
ordinate pairs* complete with an application 
which writes mouse co-ordinates directly 
into database fields. Also available to 
registered users is a technical journal called 
Forum5y intended to be a focal point for 
advice* comment etc. 

LIBRARIES 

The libraries form the core of the Base5 
system* and cover more or less every 
conceivable action you might want to 
perform. Each procedure and function is 
fully documented in the manual* with 
details of parameters required* actions 
taken and values returned when called* 
There are facilities to create, open and close 
databases* to add or delete fields and 
records* to browse* search and sort* and so 
on* Many functions can be made conditional* 
either on comparison tests, as in the case of 
searching, or on certain flags which can be 
set or reset; for example* the use deleted flag 
determines whether deleted records are 
included in a search* while the exact flag 
determines whether string comparisons 
should be case sensitive. 

One particularly attractive feature of 
BaseS is that fields can be added* deleted or 
modified (e.g. by changing their length) even 
if they contain data* Most of us have had 
experience of setting up a database and 
spending many hours entering data, only to 
find that the field structure we defined at 
the start doesnH cater for all eventualities. 
With many databases* the only solution is to 
start all over again from scratch* hut with 
Base5 this need never happen. You do of 
course have to be careful when modifying an 
existing database structure* but on balance 
the flexibility this gives is more important. 

STRUCTURES 

When setting up a database, the 
maximum number of channels, fields per 
channel and records per channel must be 
specified. Obviously there will be a trade-off 
between the sizes specified and the memory 
available in the machine. The manual gives 
some guidance on how to calculate the 
memory requirements for a given 
configuration. The ability to have more than 
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one channel open at a time is naeful when 
you want to design a relational database, 
where fielda in one file can be linked to 
fields in another. 

Fields are of fixed length format, and 
can be character^ numeric or date in type. 
Date fields have their own internal format, 
and there are procedures for accessing day, 
month and year and converting to Julian 
or Gregorian dates, as well as other 
functions relating to dates, 

DATA TRANSFER 

A database often stands or falls on its 
ability to import and export data in a 
form which can he used by other 
software. BaseS can export data in four 
different formats: Comma Separated 
Values (CSV), System Data Format 
(SDF), plain text and, usefully, 
PipeDream format. It can also import all 
of these except PipeDream, CSV is a 
common format used by many packages 
in the PC world and elsewhere. SDF is a 
fixed length record format which can be 
recognised by other software and by some 
languages, 

INPUT 

A module and a supplementary library 
are provided to handle line input from the 
keyboard. This provides the building blocks 
for comprehensive input routines, enabling 
you to control which characters are allowed, 
force upper case etc. Of course, if you are 
writing a Wimp-based application and using 
writeable icons, much of this is already done 
for you by the Wimp, but there may he 
situations where you need more control over 
input than the Wimp offers. 

PROGRAMMING A DATABASE 

Using Base5 to create a database is not 
for beginners or dabblers. You need a good 
knowledge of Basic, and the ability to 
construct complex programs. It will also pay 
to be thoroughly familiar with the manual 
before starting work on a project, since you 
really need to be aware of what Base 5 can 
and cannot do before you even start to write 
your own code, lb make use of Base5, the 
procedures and functions must be made 
available to your program by using either 
the LIBRARY or INSTALL commands from 
Basic. Having then initialised BaseS by 
calling PROChaseS, you can then proceed to 


manipulate databases using the calls 
documented in the manual, adding your own 
code to perform the functions of the program 
which do not directly involve handling files 
or data. 



WtmpBffse5 bstng used with related files, 
showing both parent and child windows open 
on the Desktop 

I must make it dear to anyone who might 
think that this provides a ready-made short 
cut to a complex database program, that a 
considerable amount of work is still involved, 
BaseS will deal with things such as opening 
and closing files; retrieving, editing and 
saving records; searching, sorting etc. 
However, it is up to you to write all the 
screen-handling routines, menus etc, (which 
means the entire Wimp interface if it is 
multi-tasking), and also the code to decide 
what to do with keyboard input, how to 
interpret the information in the database and 
so on. The advantage of this, of course, is the 
extreme flexibility it gives. Ihe appearance of 
the database, and the way it interacts with 
the user, are entirely up to you. 

FRONT END 

WimpBaseS is, as its name suggests, a 
multi-tasking front end for Basefin It is 
provided to enable the package to be used as 
a database by those who do not wish to 
write their own applications, or as an 
example for those who do. Although it is 
intended for serious use, it is not the main 
reason for the existence of BaseS, and this 
should be taken into consideration when 
comparing it with other database systems 
on the market. 
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The application itself conforms to the 
usual format for Wimp programs, with a 
main window in which the records are 
displayed, and a comprehensive menu 
structure which allows pretty well every 
standm-d database function to be performed. 
For example, file manipulation includes 
open, close, discard or recall facilities; fields 
can be added, deleted or modified and so on; 
records can be added, deleted, edited, sorted 
etc. Search facilities are included, as are 
import and export using the formats 
described above, with facilities to make 
export conditional, hy specifying either a 
range or a set of conditions. A Reports 
Designer is also built in, to allow you to 
print information fifom the database. 

An additional feature is the ability to 
relate files. Two or more files can be linked by 
a rekiie file; this describes which fields in the 
parent file are to be linked with which in the 
child. The manual describes clearly how to do 
this. Once the links are set up in this way, if 
a field from a parent file displayed in the 
main window has a related field in a diild 
file, a second window is opened to show 
information taken from the child field. 

WimpBaseS performs competently, and 
can be used hy anyone who wishes to set up 
and use a simple database with the 
minimum of effort. Indeed, there are a good 
many usei^ who bemoan the complexity of 
some databases, and for many applications 
the uncomplicated but comprehensive 
facilities provided by WimpEaseS will be 
welcome^ 1 had some small niggles about the 
way certain things had been done. For 
example, in a database of, say, 100 records, 
the first will be shown as “Record 0 of 100” 
and the last as ‘Tiecord 99 of 100”. However, 
the author of the package is receptive to 
comment and suggestion, and is continually 
making refinements in the light of feedback 
(I understand that the criticism mentioned 
above will be dealt with, for example). 

For those who buy this database with a 
view to developing their own applications, 
WimpBaseS will also prove a very useful 
tool. It appears to be robust, and is ideal for 
creating and testing data structures while 
developing an application to handle them. I 
tried this out myself, using WimpBaseS to 
create a database of my photographic slides. 
Once I was satisfied that the data structure 


was correct, I then started to write a multi¬ 
tasking application to display and handle 
the information in a format more suited to 
my own requirements. This is a task I have 
been meaning to do for many years, but it 
has taken the arrival of RISC OS and Base5 
to give me the confidence to tackle it. The 
result was very satisfactory: the Base5 
procedures worked as they should and did 
everything expected of them. The system is 
complex, but no experienced programmer 
should have difficulty in understanding it. 

CONCLUSIONS 

This package makes a valiant attempt to 
give the Archimedes a truly programmable 
database, which can be used by software 
developers to create professional, possibly 
application-specific database systems, in 
much the same way that, in the PC world, 
programmers often build systems using 
Dbase, for example. Given the power of the 
Archimedes, it is not difficult to envisage 
that some imaginative programming and a 
little enterprise could make the Arc worthy 
of consideration in some areas where a 
tailored system is needed, such as hotel 
management or doctors' surgeries. 

This is the theory, at any rate. My only 
reservation is that, in trying to cater fairly 
and squarely for the average Archimedes 
programmer, Base5 is written in Basic. 
Rightly or wrongly, Basic is not generally 
seen in the computer world at large as a 
suitable language for writing major 
applications, though thankfully Base5 is at 
least fully compatible with both Basic 
compilers. Indeed, it is more difiicult to 
write Wimp-based programs on the Arc in 
Basic than in C, for example, though 
certainly not impossible. My fear is that this 
will discourage the very people at whom 
Basefi should be aimed: programmers 
experienced at writing applications on other 
systems who see the Arc market as an 
exciting and worthwhile new venture. I hope 
this will not he the case, because we 
desperately need more powerful and 
professional business software for the Arc to 
make its presence felt in serious circles. 

Product Bases DBMS 

Supplier Bases 

PO Box 379 

Woking, Surrey GU2i 4DF. 

Prlco £69.00 ina VAT. 
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Creating Professional Disc 
Labels with Draw 


by Majid Anwar 

W ith RISC OS’s excellent printer 
drivers, making labels for your discs 
is simple. This article explains how to 
produce professional looking labels with 
relative ease, using the basic packages 
provided on the RISC OS Applications discs, 
coupled with any printer ranging from a 
humble dot-matrix right up to a powerful 
PostScript machine. 

MATERIALS 

In addition to your Archimedes, you’ll 
need a printer (but see later), the Draw 
application (on the Appl disc), a printer 
driver (also on Appl), and something to 
print on. You might also want to use Paint 
(Appl again), but more about that later. The 
label itself can be made from any of the 
following, depending on your time and 
finances: 

1, Plain paper with: 
a. double-sided tape 
b. rub-on adhesive (e.g. Pritt) 
c. spray-on adhesive (e.g. UHU) 

2. An A4 ’sheet label’ e.g. Canon 
Copystock or Crackback 

The advantages of the former option 
are that it’s cheap, and tinted paper can 
also be used. The latter, although more 
expensive, is simpler to use and less 
messy. Finally, you might like to use 
some clear sticky-backed plastic/ 
cellophane to cover the finished label, 
giving it a glossy appearance. This is 
especially useful if you are using a water- 
soluble inkjet printing system. 

CREATING THE LABEL FILE 

This section assumes that the user is 
familiar with both RISC OS (i.e. use of the 
pointer, dragging , etc.), and the Draw 
application. Remember to save your work 
regularly during this session. Start with a 
new document in Draw and create any 
rectangle somewhere on the page. Now, 
resize this precisely, thus: 

Select the rectangle to edit it. The 
rectangle will be replaced by 4 blue nodes at 
the comers connected by 4 grey lines. Click 


over the top-left node using the Adjust 
button, and then Select Enter coordinates 
from the menu. A small window should open 
up displaying the co-ordinates of the node 
relative to the bottom-left of the page. Select 
the centimetre option and replace the co¬ 
ordinates shown with x=1.0 and y=1.0 and 
then click on OK. Do the same with the 
other three such that top-right = (8.0, 8.0); 
top-left = (1.0, 8.0) and ^ttom-right = (8.0, 
1.0). You should now have a rectangle 
measuring 7cm by 7cm: the exact size of a 
3.5” disc label (it may not look this size on 
screen). This is the basic label outline in 
which any design may be placed. Fig.l 
shows the dimensions for some ’landmarks’ 
on a standard disc label. You can place and 
size them precisely using the co-ordinate 
method explained above. 


Copy the outline and place several on 
the page, but remember to stay away from 
the edge, as your printer will probably have 
a margin in which it cannot print. Load 
your printer driver (see below) and choose 
show printer margins from the Draw Misc 
menu to see the border. You can now 
proceed to design your disc label using all 
the features of Draw (see example in Fig.2), 
but make sure any fonts you need have 
been installed first. 

Continued on page 28 


( 10 . 8 . 0 ) 


( 10 . 2 . 6 ) 
(10. 2 3) 


( 10 . 1 . 0 ) 


WRITE PROTECT 
WRITE ENABLE 


(B.0.8.0) 


( 8 . 0 . 2 . 8 ) 
(8.0. 2.3) 


( 8 . 0 . 1 . 0 ) 


Figure 1. A 'standard' 3.5 Inch disc label; 
all measurements are In cms (the 'spine* Is 
another rectangle) 
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FreeSlots 


See your free memory at a gtance with this application from Majid Anwar 


I n order to see the amount of free 
memory left in your Archimedes, it is 
normally necessary to open the Task 
display window from the Task Manager 
(the A-shaped icon at the right of the icon 
bar). The total amount of free memory is 
made up of the Next and Free slots shown 
on the Task display. 

FreeSlots enables you to see this 
information continuously updated on the 
icon bar, without needing to open the Task 
display window. It works by first replacing 
the Task manager icon with a new icon 
consisting of a blank sprite, and thee 
redirecting VDU output to this sprite to 
display the values of the Next slot and the 
total free memory (i.e. Next + Free). 


USING THE APPLICATION 

Double-clicking on the IFreeSlots icon 
in a directory viewer will install the 
application, and after a short pause you 
will see the Task manager icon change to 
display two figures in place of the usual 
icon. The upper figure, in red, shows the 
current value of the Next slot, while the 
lower figure, in green, shows the total 
amount of free memory. As you install or 
remove applications you will see the 
figures change. As well as displaying this 
information, the new icon still performs 
the same function as the A-shape it 
replaced, so you could open the Task 
display window and see what happens as 
you drag the Next slot up and down with 
the mouse. 


CREATING THE APPLICATION 

First create an application directory 
called iFreeSlots. This will require a 
suitable application sprite, contained 
within a !Sprites file, and also a !Run 
Obey file with the following lines: 

IconSprites <Obey$Dir>.!Sprites 

WimpSlot -min 8K -max 8K 

Run <Obey$Dir>.iRunlmage 
If you are unsure how to create an 
application directory the simplest method 
is to use our Application Shell Generator 
(Volume 3 Issue 2 or Volume 3 Special 
Disc), 

Next, type in the listing given here and 
save it in the application directory with 
the name fRunlmage. Finally, you need a 
blank sprite to replace the Task manager 
icon sprite. Using Paint, create a sprite of 
width 38 and height 17. Fill this 
completely with colour 1 (light grey), 
name it switcher, and save it in a separate 
file in the application directory. For 
convenience you can also call this file 
Switeker, but it can have any name 
provided that you alter line 120 of the 
program to reflect the name you choose. 


You can only remove the FreeSlots 
application from the Task display window. 
Tb do this, click Menu anywhere along the 
line occupied by FreeSlots in the 
Application tasks section of the window, 
go to the submenu for the task, and select 
Quit. The original Task manager icon will 
now be restored to the icon bar. 


10 REM 

20 REM Program 
30 REM Version 
40 REM Author 


>!RanIaaga 

Free slots 
1.00 

Majid Anwar 


50 REM RISC User March 1990 


60 REH Program Subject to copyright 
70 t 

80 OH ERROR PROCerror;END 
90 DIM 255 
100 quitl-FALSE 

110 SYS "Wimp_Initialise^|200,s4B53415 
4r"Free slots" 

120 *Iconsprites <Obey$dir>.switcher 
130 : 


140 REPEAT 

150 SYS "Wiinp_Poll*'l 11111111111110, q% 
TO reasoni 

160 CASE reason! OF 
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170 mm 0 : PROCupdatesprite 
180 WHEN 17,18 : quit1=(q^!16=0) 

190 ENDCAEE 
200 UNTIL quiti 

210 SYS "Wimp BuseOfSprites" TO ,ramsp 

220 SYS "0S_Sprite0p",i.ll9,ram5pr^,"svf 
itcher^^ 

230 lql=4:ql!4=5:ql!e=ll 
240 q%!12=12:ql!L6=-l 
250 SYS "OS_ReadVduVariables%q%,q|+32 
260 xl=ql \ 4 0* 2^q^! 32 : y%=ql! 4 4 *2''q%! 36 
270 SYS "ffimp_ForceRedraw"i-1, 0,0,xl,y 
I 

2S0 SYS "Wiirip^CloseDown" 

290 END 
300 : 

310 DEFPROCupdatesprite 
320 SYS’’Wimp_SlotSize",”l, "1 TO ,next% 
f freel 

330 IF next|>free% nextWree^ 

340 SYS "Wimp BaseOfSprites" TO ,ramsp 


rl 

350 SYS "OS_SpriteOp",&l3C,ramsprl,"sw 
itcher" TO R0,Rl,R2,R3 
360 GCOLl:RECTANGLEFILL 0,0,76,64 
370 GCOLll 

380 PROCprint (STR$ fnext%/1024)+"K\ 60) 
390 GCOL13 

400 PROCprint (STR${free%/102 4) +"K% 28) 
410 SYS "OS_SpriteOp",R0,Rl,R2,R3 
420 !q%=-l;q^14=0:ql!8=0 ^ ql!12=0 
430 SYS "Wimp^SetlconState",,ql 
440 ENDPROC 
450 : 

460 DEFPRXprint(a$,yl) 

470 VDU3:HOVE 36“LENa5*8,yl;PRlNTaS 
480 EIJDPRDC 
490 ; 

500 DEFPROCerror 
510 ON ERROR OFF 
520 SYS "WixpCloseDown" 

530 PRINT REPORT?" at line ";ERL 
5«0 ENDEROC 


Creating Professional Disc Labels with Draw (continued from page 26) 


The use of sprites deserves special 
mention: sprites can be dropped directly on to 
a Draw document but can only be modified 
within Paint. An application's own sprite 
may be loaded by pressing 
Shift while double-clicking 
over the application and 
loading the !Sprites file into 
Paint. The relevant sprite 
{and maybe others) will 
appear in a window. Choose 
the sprite and ensure the 
Palette option (in the Edit 
submenu) is on. Now, save 
this sprite (not the whole 
file) and drag it onto the 
Draw window. Position and 
size it as required* 

PRINTING 

There are three ways to print your newly 
created disc label. Firstly, you can print it 
yourself. Remember to turn the 
Monochrome option off if you are using 
colours or sprites. Secondly, you can take 
your file to another Archimedes (perhaps 
with a better printer) and print it there. 
Finally, and most ambitiously, you can use 


PrinterPS ■ the PostScript driver* Set this to 
‘file* output (as opposed to parallel or serial) 
and enter a path to where you want the 
printer driver to create its file. Now print as 
normal and a PostScript 
file will be created. Finish 
off by selecting parallel or 
serial again* This 
PostScript file can be taken 
to any PostScript 
compatible printer in¬ 
cluding powerful photo- 
typesetters at your high 
street printing shop. First, 
however, use an IBM disc 
reader (for example, PC 
Disc Reader from the 
Volume 3 Special Disc) to 
copy the file onto an IBM 
disc (which is the industry 
standard for these professional machines). 
Of course, if you have your own PostScript 
printer, the quality of its printing may be 
more than good enough for your needs* 

Other labels can be produced in a similar 
way (e.g. 5** discs, videos, cassettes etc.), all 
with the same professional result. 



Figure Z Safnpte 3.5"* disc tabet 
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Canon BJ-10e Printer 


Alan Wrigley looks at Canon's new baby bubble jet. 


A t first sight the Canon BJ-lOe looks 
/^improbable. Measuring just 12 x 8.5” 
(the same size as an A4 sheet of paper) 
and about 2” thick, it would easily pass for 
a smart software package. Yet the BJ-lOe 
is an 80-column bubble jet printer which 
lacks none of the features normally found 
on full-size machines. 

THE PRINTER 

The BJ-lOe looks very smart, and is 
available in two colours, mid-grey (called 
black) and beige (called white). As well as 
being small, it is also very light in weight 
(about 4 lbs, or less than two bags of 
sugar). This has been achieved partly 
by the use of very light plastic for the 
case. At first sight this appears to be 
extremely flimsy, and flexes alarmingly, 
giving the impression of poor quality. 
However, this is quite deliberate: the 
printer has been designed first and 
foremost with portability in mind, and a 
flexible casing is less likely to be 
damaged if dropped or knocked in 
transit. 

The BJ-1 Oe is powered either firom a 
separate mains adaptor (which is 
supplied) or from batteries which fit 
into the rear of the machine. An 
optional NiCad battery pack is available 
for the latter purpose. This enables the 
printer to be used virtually anywhere and 
thus makes it the perfect companion for a 
laptop portable computer, while still 
offering all the facilities required of an 
office printer. A parallel Centronics 
interface is fitted as standard. The 
package is completed by a slim User’s 
Manual. 

The bubble jet technology is a Canon 
speciality. It is similar to that of other ink 
jet printers except that the ink is expelled 
by heating a bubble which forces the ink 
out, rather than by spraying. Ink jet 
printers have three main advantages over 
dot matrix printers. Firstly, they are 
extremely quiet in operation. Secondly, 


they are potentially more reliable since 
there are no moving pins to wear out or 
become damaged. And thirdly, print 
density is consistent throughout the life of 
the ink cartridge. Compare this with a dot 
matrix, where the print might be black for 
the first few pages with a new ribbon, 
then becomes an increasingly lighter 
shade of grey until you decide you can’t 
read it any more. The main disadvantage 
is the cost of the ink cartridge, which 
works out around 4p per sheet, compared 
with about l-2p for a dot matrix printer 
(depending on how often you change the 
ribbon!). 



The BJ-lOe In horizontal mode 

THE BJ-lOe IN USE 

The first thing to be aware of when 
using this printer with an Archimedes is 
that you will need a RISC OS printer 
driver which supports the BJ-lOe. 
PrinterDM can do this, but only if the BJ- 
lOe is included in the list of printer 
definitions. BEEBUG can supply a version 
of PrinterDM suitable for the BJ-lOe 
(which is free if you buy the printer at the 
same time). If you are using the BJ-lOe 
with applications which print without the 
aid of the RISC OS drivers, you may have 
a few problems since, although many of 
the printer codes used by the Canon are 
Epson-compatible, not all of them are. For 
example, italics are not supported, and 
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intematioiial character sets are treated in 
a different way, which makes it well nigh 
impossible to obtain a pound sign when 
printing text files {though if you have 
PiinterDM version 2.44 this can be cured - 
see the review of the new printer drivers 
in Volume 4 Issue 3). In fact, the manual 
suggests the IBM Proprinter X24E as the 
nearest equivalent. The manual gives 
little information about printer codes, 
other than to simply list them. However, 
Canon does supply a Programmer's 
Manual (£8.00) for those users who need 
to delve more deeply into the subject. 



Th& BJ-rOa In irerticai mode 


The printer can be used either 
horizontally or vertically (see photographs). 
In horizontal mode the open printer case 
acts as a guide and support for the paper, 
which is fed in from the top like a 
conventional printer. When used vertically, 
the paper is fed into a slot in the back. This 
is useful for printing envelopes and other 
thick items which vrill not go through the 
necessarily tight path which is a 
consequence of the small roller. Since the 
case has to be open for the paper to emerge 
(and thus must lie flat in front of the 
printer), there seems to be little space 
advantage in using it vertically, until you 
realise that this is a clever way of providing 
a compact auto sheet feed facility. An 
optional auto sheet feeder, not much larger 
than the printer itself, fits onto the rear of 
the BJ-lOe in the vertical position and 
feeds the paper through the rear slot. 


PERFORMANCE 

To assess the performance of the BJ- 
lOe, I compared it directly with a good- 
quality dot matrix printer, the Star XB24 
(see the review in Volume 3 Issue 9), and 
with the HP DeskJet 500, a popular ink 
jet printer costing more than the BJ-lOe 
and about six times the size. For interest, 
I also compared it with the Qume 
CryetalPrint Publisher, which is a 
PostScript printer. I chose two Draw files, 
one of which I have used before in 
comparative teats (e.g. the Laser Direct 
and the ArcLaser, Volume 3 Issue 8 and 
Volume 4 Issue 1 respectively). The 
picture is of a plant, and contains areas of 
shading in various densities, including a 
block of dense colour. The other file was a 
technical drawing containing a lot of fine 
detail. Both these files were printed at 
360x360 dpi on the Canon and Star, and 
300x300 dpi on the Qume and DeskJet. 

The results of the tests took me 
somewhat by surprise. The output from the 
Qume was crisp and sharp, as would be 
expected, though with natural subjects, 
such as the plant, the clinical half-tone dot 
patterns do not necessarily enhance the 
subject. With the technical drawing, some 
of the fine lines were far too thick and bold, 
degrading the image in some places. The 
DeskJet coped with fine lines admirably, 
and reproduced both pictures to a high 
degree of precision. However, I felt that the 
plant still lacked life, and the lines on the 
technical drawing looked a little weak 
(though for very intricate work this would 
be an advantage). The BJ-1 Oe, on the other 
hand, produced superb results from both 
files, and I have to say that, subjectively, I 
preferred the output to both the Qume and 
the DeskJet. Fine lines were crisp and 
clear, while dense areas were admirably 
reproduced as a solid block of colour. 

The XB24, as might be expected, was 
not in the same league, producing a result 
which was unmistakably from a dot matrix 
printer, though better than many. The tell¬ 
tale horizontal lines and slightly crinkled 
paper, which are the result of impact by the 
printer pins, were particularly noticeable 
across the plant. Surprisingly though, the 
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XB24 was faster, reproducing the plant in 2 
mins 55 secs as opposed to 4 mins 50 secs 
for the BJ-lOe and 3 mins 25 secs for the 
DeskJet 500 (the Qume, being a postscript 
printer, is in a different league in terms of 
speed, producing the same printout in 
around 50 secs). 

Text printing on the BJ>10e is 
reasonably fast (83 cps is claimed) and 
produces an attractive and crisp result in a 
Courier font. The only other fonts available 
are Prestige elite and proportional spacing, 
though since the standard Epson codes are 
not used for these, it will be difficult to 
make use of them. However, more and 
more applications are taking advantage of 
the RISC OS drivers, so the lack of fonts 
built into the printer should not worry 
most Archimedes owners. 

CONCLUSIONS 

If you think printers should look big 
and hunky, then the BJ-lOe is not for you. 
But if you have no such pre-conceived 
notions, then it is most definitely worthy 


of consideration. Indeed, if portability or 
silent operation are important to you, and 
if you do a lot of graphics printing and 
find the image quality firom a dot matrix 
unacceptable, then the BJ-lOe is probably 
the best choice on the market at present. 
It is cheaper than other ink jet printers, 
and a lot cheaper than a laser printer, yet 
the print quality is virtually as good as 
both of these. Canon has a real winner 
here, and provided that you plan to use it 
primarily with a RISC OS driver, then I 
can strongly recommend it. 

Product: BJ-tOo bubbto foi printor 

Supplier: Cenon (UK) Ltd. 

Canon House, 2 Manor Roed, 
Walltngton, Surrey SM6 OAJ. 

Tel: 081-773 3173. 

Price: £333.45 Inc. VAT 

(BEEBUG retail price). 

A version of PrinterDM suitable for the 
BJlOe is available from BEEBUG, costing 
£17.25 inc. VAT (supplied free when you 
buy the printer). The auto sheet feeder is 
also available at £62.10 inc. VAT. l^OJ) 
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42M Removable Drives - £585 

// you are looking for a hard drive for your Archimedes or A3000, why not consider using a 

MicroNet MR45 removable hard drive 

• Fast “The average access time is 25 milliseconds, so these are FAST devices. When used 
with an Oak SCSI card, the file transfer rate is the same as a standard 45M hard drive, 

• Reliable - The technology of these drives has been proven by use in huge quantities on the 
Apple Macintosh computers- 

• Robust - The discs, when not in the drive, are extremely robust. We (deliberately!) threw 
one half-way across the office, it dropped on the floor and rolled over a couple of times. We 
then verified it and found that it did not have a single error on it! 

• Flexible -The medium is removable, so you can use different discs for different uses, each 
with its own boot file - one for DTP, one for games etc. 

• Physically secure - The medium is removable, so you can take out the disc and lock it up 
in a safe place, 

• Secure data -The discs can be write protected, like floppy discs, to protect the data* 

• Cheap - The price of the drive, including a single 42M disc, is just £5S5 (£680 including 
VAT and carriage). Extra 42M discs are £80 each (including VAT & carriage). 

Public Domain Software 

Norwich Computer Services has a range of over 40 discs of Archimedes public domain 

softwarefrom various sources. M any of the discs contain several quite subsiantial applications 

for as Utile as £3.50 per disc. Some of the more popular applications are.^. 

• IPCDir - A desktop utility that allows the transfer of files between MS-DOS discs and 
Archimedes discs. (One of many programs on Careware N-7 - £7. The aim of Careware 
discs is to raise money for charity. For each disc, £6 is sent direct to charity.) 

• ITranslator - This application allows you to translate between various image file formats 
- sprite, GIF, TIFF. (Shareware N-21, £3.50, which also has other graphics applications.) 

• !Draw+ is an updated version of !Draw with many extra features including keyboard short¬ 
cuts, (Shareware 34, £3.50, which also has !Draw lineart and other DTP utilities.) 

• Keystrip printer - Creates I Draw keystrip from an !Edit file of the text* (Shareware N^32, 
£3.50 - also has a lol of other DTP stuff on it.) 

• YAIG - Yet Another Invaders Game - excellent implementation. (Shareware N-16, £3.50) 

• DOS filing system and CFS reader/writer -lliese are available on Shareware N^31, 
£3.50, which also has a ‘C editor and various other utilities* 

Ring, write or fax us if you want a full list of our PD software. 

Norwich Computer Services 

96a Vauxhall Street, Norwich NR2 2SD. (0603-766592 / Fax 764011) 










Programmer’s Workshop - 

Understanding E-Format Discs (Part 2) 

David Spencer continues his took at the structure of RISC OS E-format 
discs. 


In last month^s article we took a look 
at the principles on which E-format discs 
are based, and looked at the layout of the 
bitstream map that indicates what each 
chunk of disc storage is used for. In this 
article we will finish looking at the map 
by showing how its checksum is 
calculated > and then move on to look at 
the layout of the directory tree. Finally, we 
will study the allocation strategy that 
RISC OS uses to ensure the minimum 
amount of file fragmentation^ and the 
fastest possible access to files. 

THE MAP CHECKSUM 

As you will remember from the layout 
of the disc map given in the previous issue, 
the first byte of each map zone contains a 
checksum for the zone. This is used to 
detect any corruption of the map, which is 
handled in a manner described later 

The checksum of a zone is calculated 
by effectively adding together the values 
of aU the words in the zone, excluding the 
checksum byte itself. The arithmetic is 
performed modulo-32, with any carry 
being added back in. Below is a suitable 
algorithm in pseudo-code. 

Point to end of map 
Zero Carry and Total 
REPEAT 

Read 32-blt Word from map 
Total - Total + Word + Carry 
IF Total 2''32 
Total = Total - 2^32 
Carry = 1 
ELSE 
Carry s; 0 

UNTIL all words in zone read 
Subtract old checksum from Total 
Split checksum word Into four bytes 
Exclusive OR four bytes together 
to give checksum 


This nnonth’s magazine disc contains 
an assembly language implementation of 
the above algorithm. This should be called 


with register R1 pointing to the start of 
the map zone in memory, and R2 
containing the length of a map zone (in 
bytes). The routine exits with R14 
containing the single byte checksum. The 
routine can also be used to check an 
existing checksum with the result being 
returned in the Z flag. If the Z flag is set 
then the checksum for the zone is correct. 

Because corruption of the disc map 
would effectively render every file on the 
disc unreadable, RISC OS takes 
precautions to prevent corruption of the 
map, which could easily occur if the 
computer was reset while updating the 
map. What is done, is to keep two adjacent 
copies of the map. Normally, RISC OS only 
reads the Erst copy, but will write both 
copies whenever the map is updated. The 
*Checkmap command checks the integrity 
of the map against the actual disc contents, 
and if it is corrupt allows you to overwrite 
the first copy with the second. 

THE DIRECTORS STRUCTURE 

Having looked at the map struture, we 
can now move up a level and examine the 
format of the directoty structure. We will 
primarily look at the directory structure 
used on E-format discs, though the only 
difference between this and D-format is 
that the latter contains the absolute disc 
addresses of files, while the former holds 
file numbers instead. The directories used 
by the obsolescent L-format are different, 
and will not be examined. 

On E-format discs, directories are 2048 
{&800) bytes long. This means that they 
occupy two sectors on a floppy disc, and 
usually eight on an ST506-type hard disc. 
Within a directory, any sub-directories are 
simply treated as 204B-byte files, with, a 
special bit in the directory entry set to 
indicate that it refers to a sub-directory 
and not a normal file. 
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The layout of data within a directory 
is: 


Offset 

Contents 

0 

Master sequence number 

1-4 

Directory identifier 

6-30 

First directory entry 

31-56 

Second directory entry 

1981-2006 

Final directory entry 

2007 

0 (end marker) 

2008-2009 

reserved 

2010-2012 

File number of parent 

2013-2031 

Directory title 

2032-2041 

Directory name 

2042 

Master sequence number 

2043-2046 

Directory identifier 

2047 

Directory checksum 


As you can see, the bulk of the 
directory is made up of the 77 possible 
entries, with a header at the start, and 
additional information at the end. If less 
than 77 entries are present, the end of the 
list is marked by a zero byte in what 
would be the first letter of the next 
filename. The directory identifer is the 
text string ‘Nick* (after the programmer 
responsible), and is used to check that it is 
indeed a directory. The master sequence 
number^ which also appears twice in the 
directory is a value which is incremented 
each time the directory is changed. If the 
two copies differ, the directory is deemed 
corrupt, and a ‘Broken Directory* error 
given. The directory checksum is similar 
to the map checksum, but the calculation 
is more complicated. An assembly 
language program to calculate and check a 
directory checksum is given on this 
month*s magazine disc. 

The file number of the parent is used 
for *Up, or in a pathname to locate the 
parent. The directory title is a nineteen 
character long string set by *Title, while 
the directory name is the leafhame used to 
represent the directory in the parent. Both 
of these are displayed when a directory is 
catalogued. 

Each directory entry itself consists of 
twenty-six bytes, organised thus: 


Offset 

Contents 

0-9 

Filename 

10-13 

Load address 

14-17 

Execution address 

18-21 

Length 

22-24 

File number 

25 

Attributes 


The ten-character filename is terminated 
with a carriage return if shorter than the 
maximum length. Most files under RISC 
OS will be date stamped and typed, rather 
than having absolute load and execution 
addresses. In this case, the load and 
execution address fields are replaced by 
&FFFtttdd and &dddddddd respectively, 
where ttt is the filetype, and dddddddddd 
is the time in centiseconds since the start 
of the century. 

The file number was explained last 
month, and consists of the file number 
proper and possibly a sector offset within 
the cluster. Finally, for the directory entry, 
the atrributes byte indicates the access set 
by ^Access, and also whether the entry 
refers to a file or a directory. The meaning 
of each bit is: 

Bit 0 Set for R access 

Bit 1 Set for W access 

Bit 2 Set for L access 

Bit 3 Set to indicate a directory 

The root directory, $, is always grouped 
together with the two copies of the map to 
form file number 2. For example, on a 
floppy disc, where each map copy takes 
one sector, the file number of the root 
directory is &203, meaning the third 
sector in cluster number two. Having 
located the root directory, it is a simple 
matter of scanning its entries to locate the 
files contained within it, and the sub¬ 
directories. This can then be applied 
recursively to the sub-directories, meaning 
that having located the root, any file in 
the directory struture can be located. 

ALLOCATION STRATEGIES 

It is all very well defining the 
representation of the disc map and 
directory structure, but one important 
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topic we have not considered yet is how 
RISC OS allocates the storage space on 
the disc. 

In pre E-format discs, the allocation of 
disc space was simple. Each time a new 
file was saved, the operating system 
searched through the map until a large 
enough block of free space was found. Any 
gaps formed by deleting files remained as 
gaps unto filled by a new file of the same 
length or shorten This system has two 
major drawbacks. Firstly, if an attempt 
was made to extend a file that was 
trapped between two others, then nothing 
could be done if the space was not 
available, and the operation was aborted 
with an error. To avoid this, files created 
for random access were allocated vastly 
more space than they would probably 
need, in order to give the file room to 
expand. For example, RISC OS ADFS 
used to allocate 64K for each random 
access file when it was created. 

Secondly, when saving a file no attempt 
was made to minimise fi^gmentation of the 
disc space. For example, if a 15K file was 
deleted, and a i4K one saved immediately 
after, the new file would probably fit in 
place of the old one, leaving a small IK 
fragment that would only be filled if a file 
shorter than IK was then saved. This 
quickly led to the disc becoming 
fragmented, and the ^Compact command 
was needed to tidy it up. 

E-format discs are entirely different 
with a different allocation strategy. For 
one thing, as we saw last month, files ca.n 
be fragmented into a number of sections if 
need be. This means that there is no 
longer a need to over-allocate space when 
creating a random-access file. However, 
this leads to more problems, because if not 
managed properly you quickly end up 
with a large number of fragmented files 
that take longer than necessary to access. 

For this reason, Acorn have designed 
an allocation strategy that aims to reduce 
file fragmentation, and speed up access. 


This strategy only really applies to hard 
discs, which have more than one zone in 
the map. Directories are allocated from 
the middle zone outwards; hence the root 
structure will appear somewhere close to 
the middle of the disc. Whole files (not 
those created using OPENOUT) are 
placed in the nearest zone to their parent, 
working out in either direction. This 
achieves the very important goal of 
keeping files close to their parent 
directory. When these files are accessed, 
head movement, and hence access time, 
will be reduced, as the file is as close as 
possible to its parent. 

The situation with OPENOUT is more 
difficult, as random access files tend to 
change in length, and therefore require a 
different strategy. In this case, RISC OS 
searches the map zones making a trade off 
between how far out from the parent zone 
it must move and how much free space is 
in the zone. In other words, it trades fast 
access by being close to the parent against 
the possibility of having to fragment the 
file, caused by choosing a zone with not 
enough free space. 

All this is OK provided the required 
space can be found. If it can’t, RISC OS 
must decide whether to fragment the new 
file, or to move other files about to make a 
suitable gap. RISC OS contains a very 
efficient compaction routine that can 
quickly calculate how to move fragments, 
and then move them with the minimum 
fuss. When saving whole files, compaction 
continues until a large enough gap is 
formed, or the data moved about on the 
disc is over twice the length of the file 
being saved. In this latter case, the file is 
fragmented into adjacent gaps, to 
minimise head movement between one 
fragment and the next. Random access 
files are only compacted when opened or 
closed, and then only if a very good 
opportunity exists. The net efiect of this is 
that whole files are hardly ever 
fragmented, and long-lived random access 
files which may start fragmented tend to 
recombine as time goes by. 
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Archimedes Software 

Disc 7 - A Chess Program for The Archimedes. 

A Chess program that takes full ad\/antage of RISC OS, installing rtself on the icon 
Oar and running on the desktop in a window at the same time as other 
applications. You can carry on working whilst the program is thinking of its move. 
Features: ioad and save games, edtt board, step backwards and forwards through 
game, computer V computer mode, play black or white, reverse board, save 
game, muittple levels, print game. Algebraic notation. Full mouse control, on 
screen clocks. Hint. Choice of piece when promoting pawn. Undo move. 





Disc 16 - A New Spark RISC OS Archive program 

Spark, allows you to store files and directories In archive files In a very 
compressed form. e.g. sprites often take up onfy 10% of normal space. Files in 
archives, can be accessed just like files In disc directories. Now new Spark series 
2. XX, has jots mo re features. Background operation - archive whilst you do 
something else. Reads ail these formats, zoo, zip, Izh, UNIX and Archie Tar, 
Compress. Reads and writes PKarc, SEA/PC arc, uucode, atob/CET+, FCET and 
Archimedes archives. New 16 bit higher performance compression. Script files, 
message driven operation. DES data encryption. Full info, sort by type etc. 

Disc 22 - Novapaint 16 colour paint package. 

Paint package with two tone font system, user defined brushes, airbrush, auto¬ 
shader, colour fills, define graduated palettes, pixel average, area squash/ 
stretch/distort/rotate, sphere wrap, cylinder wrap. Online help, manual, demos. 
New version uses full screen for editing, but allows file load/save from desktop. 

Disc 24 - RISC OS Desktop Multitasking Terminals 

Bring Archie com ms to the desktop. Stay online whilst using other programs. 

Good quality high speed, Viewdata and ANSI/VT220/100/52 emulations. Suit 
Prestei, bulletin boards and mini/mainframes. Auto logon scripts. GET, ASCII and 
X/Ymodem (batch), file transfer. RISC OS printer driver support. !RS423state. 

Discs 12 and 26 - The World and World Map 

Database of 130,000 coordinates of points on Earth and IWorldMap to convert the 
data into IDraw fife maps which can be imported into Draw, Ovation etc. 

(Discs 12 and 26 bought together cost £6.99 and then count as one disc}. 


Disc 1 EMACS. Classic multi document editor with macro language. Includes full C source. 
Disc 4 XUSP. Object oriented version of LISP complete with C source code. 

Disc 6 C Toolkit. 20+progs for C programmers with sources, grep, awk, make, sed, more... 
Disc 6 Kermlt. Archimedes, BBC and MS DOS versions of file transfer/oommunioation. prog. 
Disc 1D More C Tools, yacc and lex with examples and C source. New versions... 

Disc 19 Starchart. RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 

Disc 29 IPcompile. Desktop wimp based front end for ISO Pascal compiler, 

Disc 30 XLIB. Library of extensions for Pascal. Interface to wimps etc. Lots of Pascal progs. 
Disc 31 PipeDream Extras. 250,000 word US English dictionary. Printer buffer, and autosave 
(automatically saves documents every so often). Needs hard disc for dictionary. 

Each disc is £5.99 inclusive. Buy four claim another one free! 

David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY51LR. 

Free Air Mail delivery on overseas orders. Full list available on request. 





























Into the Arc - 

Rise OS for Beginners 

This month we get right down to basics with a topic about which we 
receive many queries, and that is the use of ISystem. This dearly 
causes a iot of confusion for many users. Mike Wiiiiams deais with this 
topic using a question and answer approach. 


I often see references to ISyEtem. What 
is this? 

! System, also referred to as System 
Resourcesy is provided as an essential part 
of RISC OS for the Archimedes, and is to be 
found on Applications disc 1. Ite function is 
to provide a number of resource s which are 
needed (shared by) many Applications. 
These resources are usually m the form of 
modules kept in a separate Modules 
directory within the ! System appUcation 
directory. There are three such modules 
provided as standard, CLib (which is the 
C language library, required by all 
programs compiled firom C source code), 
Colours (which handles colour 
translation for Desktop programs), and 
FPEmulator (which implements floating 
point arithmetic operations on the 
Archimedes), 

If so many programs need these 
resources, why are they not 
included with the rest of RISC OS 
so that they are available as soon 
as the machine is switched on? 

This would be ideal, but would 
cause problems if and when any of the 
resources are updated (as has already 
hapjj^ned with CLib and FPEmulator). 
it would also prevent other system 
resources (which are supplied with specific 
applications) from being incorporated into 
the same system, 

OKf so what do I do with ISystem? 

ISystem. is supplied on Applications 
disc 1. When you first switch on your 
machine, insert this disc and open its 
directory viewer to show the ISystem icon. 
Once this has been done RISC OS has 
*Been' System Resources, so should any 
subsequent application require any of the 
modules it contains you will be asked to 
re-insert Applications disc 1 for the 
relevant modules to be loaded. 


If you have a system with a hard disc, 
ISystem is normally stored in the root (top 
most) directory of the hard disc. Opening 
this directory, or configuring your machine 
to boot the hard disc when the system is 
first switched on, will ensure that ISystem 
is always seen by RISC OS, Subsequently, 
any request for System Resources can be 
met straight away because RISC OS 
knows where it is located, and it is 
immediately accessible. 


Of course, if you press Ctrl-Break at 
any time you effectively reset your 
machine, so its knowledge of ISystem will 
also be lost (unless CtrLBreak reboots a 
hard disc as described above). 

In addition, if you want to ensure that 
RISC OS uses a particular copy of 
ISystem, then open the relevant directory 
viewer for this version and double-click on 
the [System icon. Note that, by default, 
this action in itself will not load any 
modules from ISystem. Properly written 
applications will always check whether a 
module is already in memory before 
attempting to load a module from 
ISystem. 



Typicai cpr7tents of ISystem and the moduies 
directory 
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Thai all sounds fairly straightforward 
However^ 1 sometimes see the message 
“System Resources not found”. Why is 
that? 

This will usually only happen if you try 
to mn an application which needs to use 
one of the !System modules^ but RISC OS 
has not seen the directory viewer 
containing ! System, so it doesn’t know 
where to find it. Tb overcome this possible 
problem, some applications come with 
their own copy of ISystem on the same 
disc, so once you open the directory viewer 
for the application, RISC OS will also 
have seen !System as well. 



Finding module names and version numbers 


Does it matter then if I have more than 
one copy of!Sysfem on different discs? 

In an ideal world, only one copy of 
I System would ever be needed, and hard 
disc users in particular would have no 
further problems. The question to ask is 
really not 'Does it matter?’ but *Why do 
some applications have their own copy of 
ISyatem if one is supplied with every 
Archimedes?’ There are two answers to 
this, and it is here that the concept of 
shared resources starts to come a little 
unstuck. 

Some applications require an updated 
version of one or more modules. Although 
Acorn will normally ensure that the copy 
of I System supplied with each Archimedes 
is updated when a new version of any 
module is released, no software house can 


rely on every purchaser having the latest 
version of each module. Thus a copy of 
ISystem with the latest version is often 
supplied with the application. 

In addition, some applications require 
modules which are not supplied as 
standard with each Archimedes. One 
example is ABC Lib which is required by 
Basic programs compiled with the ABC 
compiler from Dabs Press. This was 
required by Genesis from Software 
Solutions which used ABC to compile its 
Basic version of Genesis. 

The problem that arises with this 
approach is that any ISystem supplied 
with another application may well contain 
only the modules needed by that 
application. Suppose you have used 
Genesis as above, and then try to run 
some other application* You may well 
encounter an error message because the 
second application needs to refer to 
ISystem, but as far as RISC OS is 
concerned the copy it has seen (and hence 
the one for which it asks you to load the 
disc) is the one supplied with the first 
application. This ISystem may not contain 
the modules (or versions) needed by the 
second application. 

Another example of what can happen, 
is that the version of ISystem which RISC 
OS has seen may not contain the latest 
version of a module needed by the 
application you are trying to run, and you 
will get a message along the lines of “CLib 
version 3.5 or later needed”. You may have 
that version, but if it's not in the csopy of 
ISystem that RISC OS has seen, then 
RISC OS can’t find it. 

This now sounds very confusing* 
Apparently / may have different 
versions of ISystem on different discs, 
but RISC OS doesn’t know which one 
to use most of the time* Is there any 
way of making life simple again? 

There are two things that will help you 
and your Archimedes to run more 
smoothly. First of all, try to keep the 
number of copies of ISystem to a 
minimum. If you have a hard disc, then 
you are fortunate, and you should keep 
one single copy of ISystem in the hard 
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disc’s root directory (with a backup on a 
floppy) - but see the second point. 

The other and most crucial thing you 
can do is to ensure that all the copies of 
!System which you have are identical, that 
is that they contain the same (and latest) 
versions of the same set of modules. To do 
this, I suggest you keep one master copy of 
iSystem (it could be the one on Apps 1) 
and a list of those discs which contain 
another copy. Whenever a module is 
updated to a later version or a new 
module added to your master copy of 
ISystem, you should then replace all your 
copies with a new copy of the master, one 
reason for keeping the number of copies to 
a minimum. 

This may seem a bit of a chore, but you 
won’t need to do anything very often, and 
it will ensure that whichever copy of 
ISystem RISC OS sees first, it will always 
contain all the modules, and the latest 
versions, which any other application 
might need. Acorn has now come up with 
a utility called Sysmerge to help in 
updating ISystem, and this is increasingly 
likely to be included along with ISystem 
on applications discs by software houses 
(see Magpie review in this issue). Don’t be 
surprised if you get asked to re-insert a 
disc you last used half an hour or more 
ago - it could be that it had a copy of 
ISystem which RISC OS needs again. 

Well that doesn't sound too bad after 
all, but how do I know which is the 
version number of any module? 

This is a little more complicated, 
though if a copy of ISystem is supplied on 
a disc with other applications, the 
documentation supplied with the disc, or 
help files on the disc, may give you this 
information. Otherwise switch on your 
Archimedes and proceed as follows. 

Insert a disc containing ISystem in a 
drive, and open its directory viewer by 
clicking on the disc drive icon on the icon 
bar. Now open the application directory 
for ISystem by double-clicking on the 
ISystem icon while holding down the Shift 
key. You will see IBoot, IRun and ISprites 
files and another directory called Modules. 
Double-click on this to open it in turn. 
This will show the various modules 


supplied with this copy of ISystem (the 
icon for a module has the letters RM top 
left, and the Archimedes ‘A’ bottom right). 

For each module in turn, double-click 
on ita icon to load it into memory and then 
press FI 2 giving the **’ prompt at the foot 
of the screen. TVpe: 

Modules 

for a list of current modules. The one you 
have just loaded will be the last in the list 
(you may need to press Shift to scroll the 
display). Note that the name of the loaded 
module may well be different from its 
name in the directory viewer - for 
example, CLib appears as Shared 
CLibrary. Once you have identified the 
name of the new module, type in: 

Help <module name> 
as, for example: 

Help SharedCLibrary 
This will tell you the version number. 

It may be as well to keep a list of the 
version numbers so that you can check 
any newly acquired copy of ISystem 
against your current master version. 


Module 

Loaded 

Latest 


Name 

Version 

CLib 

SharedCLibrary 

3.66 

FPEmulator 

FPEmulator 

2.80 

Colours 

ColourTrans 

0.60 

ABCUb 

ABCLIbrary 

2.40 

MsgTrans 

MessageTrans 

0.06 

WimpUtils 

WIndowUtils 

0.04 


Table 1. Latest System Resources 


If you follow the advice I have given 
here regarding ISystem, and keep all your 
discs well organised, you should find few 
problems with ISystem, and at least you 
are now prepared for why anything might 
go wrong. For reference. Table 1 gives a 
list of the ISystem resources of which we 
are aware and the latest version number 
of each. However, do not worry if you do 
not have the latest version of each module, 
or even all the modules listed. As I said 
before, any application needing a later 
version of a module or a non-standard 
module will normally include an 
appropriate copy of ISystem on the same 
disc (we do this with RISC User magazine 
discs where necessary). 
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CAD AND CAD / CAM SOFTWARE FOR THE ARCHIMEDES / A3000 


DESIGNER 

Rnbiro 


COST EFFECTIVE CAD 


DESIGNEFLINTTRO is a powerful, yet easy to use 2D (draughting 
system, bsesed oti its big brother CESiGNEft (ARCHIMEDES]. 

It is ideal for the produotiDn af high quality, accurate drawings 
particuiariy when linked to a plotter. It makss light work of all the 
drff Icull areas of CAD. such as true blend! eg arcs and tangents, 
simple delstion of part lines and arcs, automatio batching, etn 
Further features indude ellipses, dimensioning, text move, 
rotate, mirror image, alter size, pan, zoom, etc. DESIGNER 
INTRO is an ideal Introduction to CAD. In tact it will easily cepe 
with all of most peoples draughting requirements. 


£75 


+ VAT T 

Overseas £95 



SALIDR nETURHSOFTWAFlE 

All ordafs marked “Sals or Return'' will be supplied with an evalu- 
aiiondisc in addition to the main disc. If the sof^re is returned in 
good condition, with the main disc sti II sealed, within 2S days, a tuH 
rekjnd will be given. 

(Anyone in education is welcome to have an evaluation copy to 
revlewforSB days, free of charge.) 


DESIGNER 

(ARCHIMEDES) 


MORE THAN JUST DRAUGHTING 


designer (ARCHIMEDES) offers a range of features that go 
well beyond draughtirtg. As well ss awide range of 
draughting options^ it also provides some of the mest 
comprehensive text (including font^aymbol design), drawing 
manipulation and editing cap^lities available Additionally, a 
3D effects option allows ”30'' extrusions in a variety of 
projections, and wire frame aol Ids of revolution, to becreated for 
quick and simple visualisation. The graphic design capability of 
DESiGNER (ARCHIMEDES) easily encompasses such drverse 
activities as engineeerlrvg/archrtectural drawlr^, poster design, 
logo or Sign design, dress design, oartography. elb. As welt as 
supporting a vast range of plotters, DESIGNER [ARCHIMEDES) 
al^ has specific outputs for such devices as the ROLAND 
CAMM ^ vinyl cutter and the CAMM 2engravef/mi(ler (both 
available from TrahSeft). 




£195 

Overseas £215 


‘VAT 



CNCDESIGNER 

(ARCHIMEDES) 


DRAW IT MAKE IT! 


CNC DESIGNER (ARCHIMEDES) provides a means to realise 
the true potential of CNC lathes in education. It is an integrated 
CAD / CAM system comprised of the fuH DESIGNER 
(ARCH I MEDES) system plus a fully automatic postprocessor for 
CNC lathes. Simply draw a half profile of a component usmg the 
CAO routines, and a liill CNC part program isautomaticeJIy 
generated Once generated the p^ program Is transferred te 
the lathe's own software ter manufacture, Simple or complex 
oomportenta, including part area, screwthreads, boring, even 
all ipses can be easily designed gnd realised by students of all 
ages. In many cases transfer te BBC / Master software is 
possible. Available ter a range of Boxterd, Ckmecl Danford. i 
Emcc lathes. 


+ VAT 


FuN Information Is datailsd In our Product Guide evalleble on request 


Al I ourscftvvare js packed with features far loo numerous to list in 
detail. Besides, no advertisement can show the most important 
featu re - the simplicitv of use that guarantees s short learning 
curve and rapid drawing / CNC file generation, 

ORDERING S 

Cheque with order please, payable to TechSoft UK Ud. 

Add VAT at 15% of total. (Official educational ordersweteeme.) 



OTHER PRODUCTS FROM TECHSOFT INaUD£ 

GAD and CAD f CAM Software forthe BBC B I Master series 
CAD related computer penpherals 
Plotters+accessories 
Otgitis^ 

Cutter plotters 
Engraving iTM:hme 


IffiES^CAD/CAM SPECIALISTSk 


TectiSoft UK Ltd 

Old School Larw. Errytys. MOLD, 

Clwyd CH740A. 

TsI: (OeS A3) 3ia Fsic [OSS 43} 5^4. 



































Mastering the Wimp 

Part 16: Redraw Revisited 


by Lee Catcraft 

I n part 5 of this series we looked at the 
way in which a task should respond to 
the Wimp Poll reason code with value 1 
(Redraw_Window_Request). To keep 
things simple, we made our test task 
respond to redraw requests by redrawing 
its whole window each time around. This 
is ok in a test program, but if your work 
area contains anything more than a trivial 
amount of text, you will slow down the 
Desktop to an unacceptable degree. This 
month we will take a closer look at the re¬ 
drawing process with a view to keeping it 
fast and efficient. To see how fast an 
application can respond to redraw 
requests, load a large text file into Edit, 
and then move a small window across it. 
You will see that redrawing is handled 
quite efficiently, and the progress of the 
window which you are dragging is not 
noticeably slowed - unless the text iu Edit 
contains very long lines (or worst of all, no 
carriage returns at all). In this case, 
redra w is impossibly slow. 

It takes more than a little thought to 
ensure that your Wimp task contains fast 
and effective redraw routines. The 
simplest way to achieve great speed is to 
let the Wimp do all the work, and put all 
your text into icons. This sort of approach 
is only suitable for very specific 
applications however. It is impractical for 
large quantities of text, or text that is to 
he manipulated to any degree. In such 
cases you will have to resort to writing 
your own fast redraw routine. 

REDRAWING TEXT 

The principle involved in creating fast 
text redraw routines is simple: redraw 
only that part of the window which the 
Wimp nominates. In practice you can get 
away with redrawing complete lines of 
text (of up to 40 or even 80 characters in 
length), providing you only redraw those 
lines which fall within the nominated 
area. This makes life a bit easier, since we 


only need to worry about the y co^ 
ordinates of the redraw rectangle. 

Exactly what form the code in your 
redraw loop will take depends on how you 
have stored the text which is to appear iu 
your window. Perhaps the simplest 
approach is to store it in some form of 
array. For example, a simple string array 
in which each line of the display is held in 
a separate element. This is easy to handle, 
and we will look at this case first, hut 
before doing so I will mention a more 
flexible alternative. 

If you have a sizeable quantity of text 
in your work area, and especially if you 
are to manipulate it in any way, then long 
string arrays are out, since they provide 
no flexibility at all. The only viable 
alternative is to store the text directly in 
memory, perhaps using character 13 as an 
end of line marker, or perhaps without 
any snch markers. In either case, you 
must hold an array of pointers to the start 
of each line. This is essential, because 
there is no time to work through the 
whole file to discover where each line 
begins once a redraw request has been 
received. The redraw process is extremely 
time critical, and if it is slowed down in 
any way the Desktop will become very 
sluggish indeed. 

By holding an array of pointers, you 
can immediately find the start of the line 
of text to he displayed, given the number 
of the line, counting from the start of the 
text file. We will give an example of this 
technique in due course, but we will start 
with the slightly simpler case of text held 
in a string array. 

REDRAWING TEXT HELD IN 
AN ARRAY 

The best way to see how this is 
achieved is to look at an example. The 
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procedure PROCredraw in listing 1 
implements a fast redrawing routine, and 
one whose speed is independent of the 
amount of text held. If you want to try it 
out, you can call it by placing the foDowing 
line in the Wimp Poll 
loop of an application 
program: 

WHEW 1: PROCredraw 
The procedure is 
quite self contained, 
and assumes that the 
text to be redrawn is 
held in the array 
display$0, and that 
there are currently 
dispsize% valid Lines. 

If you want to test 
the procedure out in a 
controlled way, you 
could use it with the 
very short Wimp 
program developed 
last month to illustrate the use of 
templates* In this case, you will need to 
use the Template editor to alter the main 
window as follows: 

1* Unset the auto-red raw flag 

2, Remove any icons from the window 

3* Extend the vertical work area extent 
to at least 2000 OS units 
Finally you will need to include 
PROCmakearray from listing 1. This 
simply sets up a suitable text array. This 
procedure should be called once at the 
start of the program. 

HOW IT WORKS 

PROCredraw is really a pretty 
straightforward redraw loop, designed to 
display the block of text indented by 16 OS 
units from the left hand side of the window. 
First of all we obtain the co-ordinates (in 
OS units) of the the work area origin by 
subtracting the position of the x and y 
scroll bars from the co-ordinates of the top 
left-hand comer of the visible area. All this 
information is returned by the call to SYS 
“Wimp_RedrawWindQw”. Table 1 gives the 
parameters, but see also the PRM page 
1204 for further details. 


As you can see from the program there 
are two nested WHILE loops. The outer 
one cycles round once for each rectangle 
which the Wimp requests to be redrawn, 
while the inner one prints just those lines 
which feature in 
the nominated 
rectangle. This is 
achieved by 

obtaining values for 
top% and 6aae%. 
These are the 
upper and lower 
bounds of the 
region that the 
Wimp has 

requested to be 
redrawn, and are 
measured in OS 
units relative to the 
work area origin. 
To determine which 
lines of the array to 
print we just divide 
these values by 32 (since each line of text 
is 32 OS units in height regardless of 
which mode is used in the Desktop). At 
the bottom end (base%) we add a small 
measure to counteract the effect of 
rounding down (since integer division is 
used), and there you have it. 

The case where the text to be written 
is held in a block of memory is very 
similar. Suppose that the array array%0 
contained a set of pointers to the start of 
each line of text in such a way that 
arrayWo(O) contained the address of the 
start of the first line of text, and so on. All 
we would need to do to alter PROCredraw 
appropriately is to replace the PRINT 
statement by: 

PRINT $arrayl{i%) 

This assumes that each line of text is 
terminated by a carriage return character 
in memory. 

Incidentally, to see just how slowly the 
redraw routine operates when the whole 
text file is redrawn in response to every 
redraw request, alter the assignments of 
top% and hase% in the outer WHILE loop 


On entry 

R1=poinlerto block 

On exit 

R0=0 for no more rectangles to 
redraw 

R1+0 

window handle 

R1+4 

visible area min x coord 

R1+8 

visible area min y coord 

R1 + 12 

visible area max x coord 

RU16 

visible area max y coord 

R1+20 

scroll X offset rel to wae origin 

R1+24 

scroll y offset rel to was origin 

R1+28 

cum graphics window min x ooord 

R1+32 

cum graphics window min y coord 

RU36 

cum graphics window max x coord 

R1+40 

curr graphics window max y coord 


Table Parameter block returned with 
SYS ”Wlnip_HedrawWlnd 0 w“ and SYS 
"*WimpjGe tRectangfe". 
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Mastering the Wimp 


top^=l 

base^=dispsize| 

If you now re-nin the program you will see 
that any attempt to drag an object across 
the task's window is impossibly slow * and 
this is only with a very short text hie. 



Twyiait 


You can test the speed o f redraw by dragging a 
smalt window across the window of your task. 


REDRAWING GRAPHICS 

When redrawing graphics objects, two 
different approaches can be adopted^ 
Either you can use a technique similar to 
that discussed above for use with text, 
where you determine the co-ordinates of 
the area to be redrawn, and redraw just 
that area; or you can take a short-cut and 
use sprites. In practice, the first of these 
two methods may not be feasible in all 
situations. It may not be possible to draw 
the right hand part of a graphic without 
having drawn the left part first - or at 
least without having calculated where 
the left hand part would fall. Also there 
may be no easy way to know exactly 
which part of your drawing code to 
activate to draw a particular segment of 
a drawing. 

For example, suppose the graphic is a 
map of the U. K, and that it is drawn from 
an array of points. There is no obvious 
way to get from the bounding rectangle 
returned by the Wimp with a redraw 


request to co-ordinates of the points 
required to redraw the nominated area. In 
such cases, the fastest redraw will often 
be obtained by initially drawing the 
graphic to a sprite, and then redrawing 
this in full when redraw requests are 
made. Of course large sprites can take up 
a great deal of memory, but this method 
can be very effective. If you are interested 
in pursuing it you are referred to the 
Desktop Graph Plotter described in RISC 
User Volume 4 Issue 1 page 15, where this 
technique is used to good effect. 

Next month we will be finishing off the 
series with a look at the way in which 
applications can interface with the RISC 
OS printer drivers. 

1000 DEFPROCredravf 

1010 SYS '^Wui^ RodrawWiadow" , ,block| TO 
morel 

1020 xOI-16+blocltl! 4-blockl !20 
1030 Y0i»-16+blockl !l6-blockl!24 
1040 iraiLE morel 


1050 

topl=(y0l-blockl!40) DIV 

32 

1060 

IF topKO THEN topl-0 


1070 

basel=(47+y0%-block% 1 32) 

DIV 32 

1080 

il=topl 


1090 

WHILE i|<dispsizel AND i|<-base| 

1100 

MOVE xOI,yOI-(il«5) 


1110 

PRINT display${i|) 


1120 

il+=l 


1130 

ENDWHILE 


1140 

SYS "Wimp GetRectangle" ,, 

block1 


TO morel 
1150 ENDWHILE 
1160 ENDPROC 
1170 : 

1180 DEFPROCmakearray 

1190 DIM display$(2D0j:BI^1 

1200 A$=STRING${8,'^RISC User 

1210 FOR Al-0 TO 200 

1220 display$(Al)=MIDS60J 

1230 BI=BI MOD 10 +1 

1240 NEXT 

1250 dispsirel=A|+l 
1260 ENDPRX 


RISC User March 1991 


43 















Pirate Software 


Tht ultimate rally 
driving simulator 
for the Archh 
medesp incorpor¬ 
ating 4 bfllion 
fractal generated 
landscapes. 3D 
solid polygon 



graphics, samp¬ 
led speech for 
course notes * 
you will even be 
able to win prizes 
by entering the 
regular prize ral¬ 
lies I 


Proudly Presents 

Fast ‘n’ Loose 


Only £17.50 including VAT and Post. 

For free playable demo, version, sand a blank disk and a SAE. 

Avallabte only by man oidar from Ptrai^r Softwara, P,0. Boit Huddorslteld, Wmi Vorkehlre. HDt 1YH. 


"F I R S T" 

ADVAIMOED STATISTICAL SYSTEM 

For Acom Archlm0de$; BBC Models B, B+ and Master; "industry Standard’ machines 
A powerful and practical tool for Reseorch, Industry, Business, and Teaching 

Integrated, interactive, robust, fast, accurate, modular. Designed to fadlitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterpiots, regression plots, function plots. 

Univariate statistics. Paired and unpaired t tests. Chlsquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predk:ted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs. influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoottiing. causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibfalion. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 

Price E120-£1BQ {machine and version dependent). Special RISC USER discount available. 
There's for too much fo describe here. Get full Iriformotion now from: 

Serious Stotlsticai SoTfwcre, Lyrrwood, Benty Hecrth Uxne, Wllloston, South Wlnal L641SD Tel. 051 327 4266 









BEST SOFTWARE 
BEST PRICES 


Q a in t s 


Alerion 

£12.95 

All in Boxing 

£12.95 

Apocalypse 

£26.95 

Arcade Soccer 

£17.95 

Battletanks 

£U.95 

Bug Hunter 

£16.95 

Caverns 

£1655 

Chocks Away 

£2255 

Conqueror 

£22.95 

Cops 

£17.95 

Cbmiption 

£26.95 

Drop Ship 

£1755 

E-Type 

£17.95 

Fireball n 

£17.95 

Fish 

£26.95 

Guild of Thieves 

£26.95 

Herewith the Ques 

£22.95 

Holed Out 

£17.95 

Holed Out Designer 

£17.95 

Hostages 

£17.95 

Hoverbod 

£12.95 

Ibix the Vildx^ 

£17.95 

Inertia 

£17.95 

Interdktor II 

£30.95 

Jet Fighter 

£1255 

Mad Professor Mariarti 

07.95 

Maddingly Hall 

£12.95 

Man at Arms 

£17.95 

Manchester Uiuted 

£21.95 

Minotaur 

£12.95 

Missile Control 

£12.95 

Nevryon 

£17.95 

Orion 

£12.95 

Overload 

£12.95 

Pipemania 

£21.95 

Pon 1 

£15.95 

Pysanld 

£17.95 

Real McCoy 

£26.95 

Redshift 

£15.95 

Repton 3 

£17.95 

Rotor 

£21.95 

Sporting Triangles 

£2155 

Superior Golf 

£17.95 

Talisman 

£13.95 

The Olympics 

£17.95 

The Pawn 

£26.95 

The Wimp Game 

£17.95 

Thundermonk 

£13.95 

Trivial Pursuit 

£2655 

UI.M. 

£26.95 

White Magic II 

£17.95 

Worid Cl Leader Board 

£26.95 

Zarch 

£1755 


St rioas 


1st Word Plus n 

£7955 

8 bit Sampler A Midi 

£179.95 

8 bit Sound Sampler 

£124.95 

Acorn DTP 

£139.95 

Alpha Base 

£44.95 

Ancestry 

£69.95 

Ansi C Release 3 

£144.95 

Arc Comm 

£29.95 

ArcPCB 

£174.95 

Arc PCB Professional 

£319.95 

ArcDFS 

£2655 

Archimedes 3.5" Drive 

£89.95 

Arc Assembly Lang 

£19.95 

Arc Basic Compiler 

£89.95 

ArcHght 

£44.95 

Annadeus (software) 

£6955 

Armadeus (hardware) 

£13955 

Artisan 2 

£49.95 

Assembler 

£199,95 

Atelier 

£89.95 

Autosketch Version 2 

£79.95 

Cambridge Pascal 

£69.95 

Data vision 

£129.95 

Deltabase 

£25.95 

Desktop Office 

£109.95 

Disc Tree Version 2 

£44.95 

Easiword 

£3455 

Euclid 

£59.95 

Film Maker 

£84.95 

Financial Accoimtant 

£229.95 

Flexifile 

£129.95 

Fortran 77 release 2 

£94.95 

Gamma Plot 

£59.95 

Genesis 

£84.95 

Gerber Plot 

£104.95 

GraphBox Version 2 

£69.95 

Hearsay 

£59.95 

Home Accounts 

£44.95 

Hotlink Presorter 

£49.95 

Impression n 

£164.95 

Impression Junior 

£89.95 

Instigator 

£44.95 

Iso Pascal Release 2 

£9955 

Kirowledge Organiser 

£49.95 

Lisp 

£199.95 

Logistix 

£99.95 

Mailshot 

£36.96 

Mogul 

£17.95 

Multistore Vn 

a49.95 

Newhall Font Pack 

£44.95 

Nomiiud Lecher 

£57.95 

Ovation 

£99.95 

PC Access 

£34.95 


PC Emulator £99.95 

Pipedream 3 £144,95 

Presentation System £69.95 
Presenter II £39.95 

Pro Artisem £84.95 

Prolog £199.95 

Purchase Ledger £57.95 

Realtime Solids Modler £164.95 

Render Bender £70.95 

Reporter £34.95 

Rhapsody £44.95 

Rise Basic Compiler £129.95 

Rise Forth £129.95 

Progs. Ref. Manual £79.95 

Robo Logo £86.95 

Sales Ledger £57.95 

Scan Light Junior Arc £199.95 

Scan Ught Junior A3000 £199.95 

Scan light Senior £429.95 

Schema £109.95 

School Administrator £69.95 

Sigma Sheet £59.95 

Software Dev. Toolbox £199.95 

SolidCad £129.95 

SoUdsRender £129.95 

SoUdtools £319.95 

Spellmaster 09.95 

Stock Management £57.95 

System Delta Plus £69.95 

Tempest DTP £109.95 

Tracker £44.95 


CXjt software price list offers all the 
latest Archimedes software at a 
discount of around 10% or more. All 
listed prices include VAT and P&P. 
Goods are normally despatched first 
class within 46 hours. - subject to 
avallabiiity- 

URCHYNIfl SOFTWfiRE SCIPPUES, 

POBox19n. 

Sutton Coldfield. 

B74 3QZ. 


PubBc Domain Software 

We are still able to offer the best 
Archimedes PD selection, with a 
fast efficient service for only £1.60 
per disc. Send a £1 cheque or coin 
for Arcaynia Demo/Catalogue Disc 
4 . Or send a SAE for a full Bst of all 
our Commercial and PD software. 













WP/DTP _ 

Using the iBM Character Set with ist Word Pius 

by Mike Hunter 


Implementing this facilUy requires a data 
file which is supplied only on this month's 
magazine disc, 

1st Word Plus uses the application 
IstChars tor the entry of non-keyboard 
characters into the text. This displays the 
'printable’ characters of the current 
alphabet in a window. Clicking with the 
mouse on a character in this window 
enters that character into the text at the 
current caret position. Any alphabet may 
be selected, and will be displayed in the 
IstChars window. 


(UK) alphabet, but overwrites characters 
&A0-&FE with some characters from the 
standard IBM alphabet, using 
Vr>U23,n,dl»dS sequences stored on disc 
as a file called Alpha_IBM. Characters 
&80-&9F are not displayed by IstChars, 
and in any case some of these are needed 
by RISC OS for window icons, so the IBM 
characters normally coded in this range 
instead replace some of the less useful 
graphic characters at &B0-&CF. 
Characters &A0-&AF and &E0-&FE are 
standard IBM printer characters, while 
&D0-&DF provide some of the printable 
IBM graphics characters. 


Unfortunately, the printer drivers 
supplied with 1st Word Plus do not 
match the characters in any of the 
RISC OS alphabets. Thus, even with 
the default (UK) alphabet, there are 
characters which can be inserted into a 
1st Word Plus document on the screen, 
but which will not print on paper. 

In principle, some printers which 
accept downloaded character 
definitions could be made to print all 
the 'printable’ characters correctly. 
However, some printers have very 
limited download capabilities (e.g. 
Epson LX), or downloading requires 
setting a DIP-switch or sacrificing the 
print buffer (e.g. Epson LQ). In any 
case, Acorn does not provide 
downloadable fonts, even for its 
default alphabet. 

This article explains how you can use a 
new application IBM chars to define an 
alphabet, with some useful characters 
(e.g. Greek and other characters 
commonly used in scientific writing) not 
present in the default Archimedes 
alphabet, all of which may be printed on a 
printer which has the standard IBM 
character set (true of many printers on the 
market). 

The IBMchars alphabet uses characters 
&20-&7E from the Archimedes default 



Jst Word Pius with window showing ISM-Iiko 
character set 

To print the alphabet defined by 
IBMchars, a suitable printer driver must 
be installed in 1st Word Plus. Many Epson 
(and compatible) printers will print the 
IBM character set while remaining in 
Epson mode, on a software command, 
without requiring DlP-switches to be 
changed. The printer driver I use does this 
for my LQ-compatible Star LC24-iO. 
However, very few alterations should be 
needed for other Epson/compatible printers, 
or for printers in IBM emulation mode. 

IMPLEMENTING IBMchars 

To use IBMchars you will need to 
create a modified version of the 1st Word 
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WP/DTP - Using the IBM Character Set with 1st Word Plus 


Plus IstChars application and save it with 
this new name. Both lstWord+ and 
IstChars are supplied by Acorn on the Ist 
Word Plus Program Disc^ and it is a good 
idea to install IBM chars on the same disc^ 
or even better on a backup of the original 
which you use as your working copy» 

First of all you will need a new 
application directory to be called 
IIBMchars. Such a directory is supplied on 
this month^s magazine disc ready for use. 

The file Alpha_IBM {supplied on the 
magazine disc) in IBMchara contains the 
definitions for the IBM character set- This 
application also contains an alternative 
sprite to be used as the application's icon - 
you could design your own if you wish. 

You will also need to copy the 
IRunlmage and Templates files from 
within IstChars to the new application 
IBMchars. In addition you will need to 
incorporate a !Run file in your new 
application. Head the IBun file from 
IstChars into Edit, add the following two 
lines following the initial comment line, 
and then save this version as !Run in the 
!IBMchars directory: 


Print <0bey$Dir>.Alpha_IBM 
Copy adf 3;;IWP P rog,$.11s tWordt.<newjlriver > 
adf3::iWPProg.$,tIstWordi.lwp_print F-C 


Note that <new_driver> is the modified 
printer driver for IBM characters (see 
below). 

To be able to revert to the normal 
character set (using IstChars) it is helpful 
to modify similarly the !Run file in the 
!IstChars directory to include: 


Copy adfs::IWP^Prog.$.!lstWord+.<noxmal driver> 
adfs::lWP_Prog.$.!IstWordi.lwp_j>rint F-C 


where <normal_driver> is your normal 
printer driver. 


driver for use with your own printer which 
will select the IBM character set. The 
magazine disc contains source and 
assembled printer drivers for the Star 
LG 10 and LC24 printers (in directories 
Source and Config within IBMchars). 

The sources supplied may be used for 
guidance if you need to create your own 
printer driver. The principal requirement 
is to specify the translation table between 
the character codes used by the Arc and 
those used by the standard IBM character 
set. Use the 1st Word Plus utility 
IstConvrt to convert the source for any 
printer driver of your own into the printer 
driver itself. 

Assembled printer drivers should be 
saved in the IlstWord‘<“ directory. This 
applies if you use either of the printer 
drivers from the magazine disc. 

Once IBMchaTB has been set up in this 
way, double-clicking on the IBMchars 
application will open a window showing 
the modified (IBM) character set (see 
illustration) and select the modified 
printer driver, while double-clicking on 
the IstChars application icon will restore 
(or select) the standard character set and 
the default printer driver, 

PROBLEMS 

Problems - character &A0 is assumed 
by 1st Word Plus to be a hard (non-break 
or fixed) space, and is shown as such in 
the IstChars character set window, 
regardless of how it is actually defined. 
IBMchars codes &A0 as a (a acute). The 
character &FP is shown as y (y umlaut) in 
the IstChars standard alphabet, but 
cannot be inserted into a document 
(IBMchars treats &FF as non- 
printable). The IstChars character set 
is displayed in a non-standard order 
intended to make its layout more 
logical. With the IBMchars alphabet, the 
result is less satisfactoTy. 


1st Word Plus also provides the source 
for creating your own printer drivers. You 
may need to create a modified printer 


Next monlk we hope to return to the topic 
of letter writing using DTP with more 
advice on leUerkeads. 
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Archimedes Memory Upgrades 


4Mb of RAM for your 

A310 or A305 is now only 
£399 inc. VAT/fitting 

This includes a free MEMCfa worth 
nearly E80, while stocks last. 

* ARMS compatible. 

* MEMCIa upgrade supplied. 

'k Fully compatible with upgrades 
such as hard discs and 
backplanes. 

* Price includes fitting and carriage 
both ways. 


A3000 RAM 

2Mb (total), £69. Upgradable to 4Mb. 
4Mb (total), £220. 

Bare board, £29. 

A data sheet is available for these upgrades. 
This e?cplains the type of chips needed for 
the '’bare board", which has high quality 
sockets for the RAM chips. Only 8 devices 
are required. 

400/1 series RAM 

lMb,£58. 2Mb, £100. 3Mb, £130 

Impression 2 

This is still only £145 inc. VAT when bought 
at the same time as any memory upgrade. 

Combination deals 

We can suppy and fit ARM3 upgrades as well 
as a range of hard discs. Call us to discuss 
your requirements. 


Why is it so inexpensive? 

Quite simply, by design. By using as few 
components as possible, the size of the 
board is reduced and production costs are 
lower. We implement 4Mb using just 11 
chips, whereas some other expansions 
need over 50! The use of fewer 
components results in lower power 
consumption, and greater reliability. 

SMb potential I 

The small size of the board even allows an 
SMb upgrade to be fitted - the A380? This 
would be impossible with other RAM 
expansions. Our information pack gives 
further details. 

For £399 inc- VAT you get; 

★ Courier collection of your machine. 

★ The improved memoiy controller, 
MEMCIa. This upgrade alone has an 
RRP of £79.35, and boosts the speed of 
the machine by approximately 10%. 

★ Fitting and testing of the 4Mb memory 
upgrade, 

★ Courier return of your computer, 

★ 12 mon th' s w arranty, 

Fitting time 

We use an overnight courier service both 
ways, and can therefore offer a turnaround 
of typically 2 or 3 days. 

Further details 

An information pack is available which 
gives further details on this upgrade. 

Write or phone for a free copy. 

Ordering details. All prices inctude VAT. 
Pay ment by Access. Visa or cheque with order. 
Official and overseas orders we Iconic. 


IFEL, 36 Upland Drive, Derriford, Plymouth, PL6 6BD. (0752) 847286 














Bicubic Parametric What? - 

A first look at Bezier Curves (Part 2) 

Derek Marriott con dudes his discussion of Bezier curves by looking at 
their application to three-’dimensionai objects. 


THE THIRD DIMENSION 

One of the most popular methods for 
describing a surface in computer graphics 
is the Bezi&r Patchy developed in the 1960a 
by Pierre Bezier for use in the design of 
car body panels for Renault. His computer 
aided design (CAD) package was in use by 
1972, and was used for the design of 
Renault bodies throughout the 70s. 

We can build on what we know for 
curves to produce a formula for patches: 

3 3 

P(u, v) = S S Bi_ 3(u)Bj_ 3(v) 
i =0 j =0 

The blending function is the same as was 
used before. Note that we now have two 
parameters, u and v, and two cubic 
equationsj so we have a bicubic 
parametric patch* This is remarkably 
similar to the formula for the curve, 
except that we have two variables u and v 
which vary between 0 and 1. There are 
now 16 control points arranged in a 4x4 
matrix, and these relate to the patch as 
shown in figure 4. The corner points, Poo, 
Po 3 and P 33 , are, like the end points 
of the curve, on the surface of the patch, 
the other points exert a pull on the sinrface 
to produce the required shape. 



This can be programmed as an 
extension of that used to draw a curve, 


except that the output is now in three 
dimensions so some translation of the 
output is also required to produce a two- 
dimensional screen image (such a 
program is included on the magazine disc 
as Bezier4. Since matters are getting more 
interesting, the program contains a little 
extra code to allow several patches to be 
drawn). 

As before, such a program is very slow, 
and thus impractical, so we shall devise a 
subdivision algorithm, which is also where 
things start to get complicated. 



Draw out the control points of the 
patch on a flat surface, to make life easy, 
as in figure 5a. Using the same technique 
as for curves, we can split the rows of 
control points, in u, into two, to produce, 
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Bicubic Parametric What? 


notionally^ two long, thin patches as shown 
in figure 5b, Now we take each of these 
thin patches and split them along v, or 
along the columns of control points, and 
produce two square patches for each long 
thin patch {figure 5c), So one large patch is 
divided into four small ones. To draw the 
patch all one does is to draw the square 
connecting the comer control points. 

The program which does this Qisting 5) 
is really very simple considering the 
output from it. It is not lightning fast, 
but it is in Basic, and it does show what 
can be done. The version on the 
magazine disc includes the (much 
longer) data for that universal test 
object, a sphere. 

Again, Flatness can be associated 
with a patch, but this produces tears in 
the patch (figure 6) as not all of the 
patches are being divided equally This 
is overcome by post-processing the 
image for the holes (which appear as 
small black regions on objects which 
have been shaded). A second program 
looks at the screen image finally 
produced, looking for the holes and 
filling them in. Although this sounds like 
cheating it works, I shall leave this as an 
exercise for the reader. 



Figure 6, Tears formed by nan-uniform 
subdivision 

A further version of listing 5 (the 
program Be^ie^6) is included on the 
magazine disc. This allows a choice of 
object from data definitions kept in a 
separate file (created with Edit). The 
model of the Utah teapot (see figure 7), 


developed by M, Newell in 1975, is an 
object which has become a benchmark in 
computer graphics. Its curves and holes 
provide the ideal way to test shading 
algorithms to the limit, and it is also 
infinitely more interesting than spheres. 
It consists of 306 co-ordinates (3D) 
composed into 32 patches, arranged in 4 
groups - the body, lid, spout and handle. 
It’s just a shame the lid doesn’t fit 
properly (you can alter the data easily to 
make it fit)! 



Figure 7. The Utah teapot 


So there you have a short trip through 
the world of Bezier curves and patches. 
The routines presented are crying out for a 
machine code implementation as they are 
so simple. I have used real numbers for the 
calculations as the data for the Utah 
teapot comes as such, but the routines 
work equally well with integers. You may 
like to add hidden surface removal to a 
patch, i,e, divide only if the patch is visible, 
or shading which does have some problems 
in that triangle^shaped patches have two 
comer control points the same which gives 
a surface normal of zero (see the sphere or 
teapot lid). 

So where can you go from here? A 
starting point would be to alter listing 5 to 
allow for non-nniform subdivision and 
investigate the problem of tears, but that 
is just an idea. Play with the objects and 
find out why most 3D packages, to date, 
use polygon mesh models. 
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References: 

Watt, Alan (1989); Fundamentals Of 
Three-Dimensional Computer Graphics 
(pp.ll 5-139). 

Burger, R, Gillies D. (1989); Inieractive 
Computer Graphics - Functional^, 
Procedural and Device-Level Methods 
(pp.241-283). 

My thanks to Ste Maddock, University of 
ShefBeld, for the ideas. 

Listing 5 

10 REM >Beaier5 

20 REM Recursive Subdivision 

30 REM Version Al.O 

^0 REM Author Derek Marriott 

50 REM RISC User March 1991 

60 REM Program Subject to copyright 

70 : 

80 MODE 12 
90 GCOL 128:CLG 

100 S-2 :RZM Seals value for image 
110 PROCsetupcontrol 
120 diEtl=^30000:ORIGIN 640, 512 
130 PROCinitvtrans{250, 60, 60) 

140 DIM patch(3,3,3) 

150 llumber=3 :REM Number of divisions 
160 FOR Count1=1 TO Patches^ 

170 FOR ul=0 TO 3 
leO FOR v^-0 TO 3 
190 FOR planel=l TO 3 
200 patch fu%,vl,planed)=V(P(Count % 

,planel) 

210 NEXT 
220 NEXT 
230 NEXT 

240 PROCdrawEez [patch {), Number) 

250 NEXT 
260 END 
270 : 

280 DEF PROCdrawBez(F{),N) 

290 LOCAL Topleft (),T 0 pright() ,Botlsft 
0 pBotright () 

300 DIM Topleft (3,3,3 ),Topright (3,3,3) 

, Botleft (3,3,3), Botright (3,3,3) 

310 IF N-0 THEN 

320 P ROCd rawpat ch(P{)) 

330 ELSE 

340 PROCsplitpatch(P [),Topleft{), Topr 
ight{),Botleft f),Botright()) 


350 PRDCdrawBez(Topleft0, N^l) 

360 PROCdrawBez(Botle f10i N-1) 

370 PROCdrawBez(Topright(),N-1) 

380 PROCdrawBez{Botright(),N-1) 

390 ENDIF 
400 ENDPROC 
410 : 

420 DEF PROCsplitpatch (P (),RETURN Topl 
eft(),RETURN Topright {), RETURN Botleft () 
,RETURN Botright {)) 

430 REM patches (3,3) 

440 LOCAL BigPatchO ,splitplan 
el,left 0,right () 

450 DIM BigPatch{6,6,3),left{3,3,3),ri 
ght{3,3,3):REM Holds total grid 
460 PRCX:splitInD(P {) ,BigPatch ()) 

470 FOR splitl=0 TO 3 
480 FOR Vl=0 TO 3 
490 FOR planel^l TO 3 
500 left(splitI,V%,plane!) -BigPatc 

h{split!,V!,plane!) 

510 right{splitl,V!,plane!)=BigFatc 

h{3+spLit!,VI,plane!) 

520 NEXT 
530 NEXT 
540 NEXT 

550 PROCsplitInV{left{),BigPatch{)) 

560 FOR spiitl=0 TO 3 
570 FOR U!=0 TO 3 
580 FOR planel=l TO 3 
590 Topleft(Ul,splitI,plane!)=BigPa 

tch{Ul,split!,plane!) 

600 Botleft(U!,splitl,plane!)=BigPa 

tch [D!,3+splitl,plane!) 

610 NEXT 
620 NEXT 
630 NEXT 

640 PROCsplitInV {right {), BigPatch ()) 
650 FOR split!=Q TO 3 
660 FOR U!=0 TO 3 
670 FOR plane!=l TO 3 
680 Topright(U!,split!,piane!)=BigP 

atch(U!,split!,plane!) 

690 Botright{U!,split!,plane!)=EigP 

atch{U!,3+split!,plane!) 

700 NEXT 
710 NEXT 
720 NEXT 
730 ENDPRX 
740 : 

750 DEF PRXsplitInU(patch{),RETURN Bi 
gPatchO) 
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760 REM A Patch into a 7,7 matrix 
770 REM u >,v 
780 LOCAL V%,plane%,C 
790 FOR Vl«0 TO 3 
800 FOR plane1=1 TO 3 
810 C=(patch(l,V%,planel) + patch(2, 

V%,plane%))/2 

820 BigPatch(0,V%,planel) * patch(0, 
V%,plane!) 

830 BigPatch(l,V%,plane!) * (patch(0 
,V!,plane!) + patch(1,V%,plane!))/2 
840 BigPatch(2,V!,plane!) « (BigPatc 
h(l,V!,plane!) + C)/2 

850 BigPatch(6,V!,plane!) * patch(3, 
V!,plane!) 

860 BigPatch(5,V!,plane!) « (patch(2 
,V!,plane!) + patch (3,V!,plane!))/2 
870 BigPatch(4,V!,plane!) - (BigPatc 
h(5,V!,plane!)+ C)/2 

880 BigPatch(3,V!,plane!) - (BigPatc 
h(2,V!,plane!) + BigPatch(4,V!,plane!))/ 
2 

890 NEXT 
900 NEXT 
910 ENDPROC 
920 : 

930 DEF PROCsplitInV(patch0,RETURN Bi 
gPatchO) 

940 REM A Patch into a 7,7 matrix 
950 REM u >,v 
960 LOCAL U!,plane!,C 
970 FOR U!«0 TO 3 
980 FOR plane!-l TO 3 
990 C - (patch(U!,1,plane!) + patch( 
U!,2,plane!))/2 

1000 BigPatch(U!,0,plane!) = patch(U! 
,0,plane!) 

1010 BigPatch(U!,l,plane!) = (patch(U 
!,0,plane!) + patch (U!,l,plane!))/2 
1020 BigPatch(D!,2,plane!) * (BigPatc 
h(U!,l,plane!) + C)/2 
1030 BigPatch(U!,6,plane!) « patch(U! 
,3,plane!) 

1040 BigPatch(U!,5,plane!) « (patch(U 
!,2,plane!) + patch(U!,3,plane!))/2 
1050 BigPatch(U!,4,plane!) * (BigPatc 
h(U!,5,plane!) + C)/2 
1060 BigPatch(U!,3,plane!) * (BigPatc 
h(U!,2,plane!) + BigPatch (U!,4,plane!))/ 
2 

1070 NEXT 
1080 NEXT 


1090 ENDPRX 
1100 ; 

1110 DEF PROCdrawpatch(P()) 

1120 REM P has vertices in it 
1130 PROCmove3D(P(0,0,1),P(0,0,2),P(0,0 
,3)) 

1140 PRCXMraw3D (P (3,0,1),P (3,0,2),P (3,0 
,3)) 

1150 PROCdraw3D(P (3,3,1),P(3,3,2),P(3,3 
,3)) 

1160 PROCdraw3D(P (0,3,1),P (0,3,2),P(0,3 
,3)) 

1170 PROCdraw3D(P (0,0,1),P (0,0,2),P(0,0 
,3)) 

1180 ENDPROC 
1190 : 

1200 DEF PROCmove3D(x,y, z) 

1210 REM moves absolute line in 3D 
1220 PROCpoint(x,y, 2 ):MOVE xs,ys 
1230 ENDPROC 
1240 : 

1250 DEF PROCdraw3D(x,y,z) 

1260 REM draws absolute line in 3D 
1270 PROCpoint(x,y,z):DRAW xs,ys 
1280 ENDPROC 
1290 : 

1300 DEF PROCpoint(x,y,z) 

1310 REM xs,ys contain 2D screen coord 
1320 PROCvtrans (x,y,z) 

1330 ENDPROC 
1340 : 

1350 DEF PROCinitvtrans (rho,theta,phi) 
1360 REM Initiates viewing matrix 
1370 LOCAL st,ct,sp,cp 
1380 st=SIN(RAD(theta)) 

1390 ct-COS(RAD(theta)) 

1400 sp-SIN(RAD(phi)):cp-COS(RAD(phi)) 
1410 va»-st:vb-ct:ve=-ct^cp:vf«-st*cp 
1420 vg=sp:vi«*-ct*sp;vj—st*sp 
1430 vk=--cp:vl=rho 
1440 ENDPROC 
1450 : 

1460 DEF PROCvtrans(x,y,z) 

1470 REM Perform transformation 
1480 xe=va*x+vb*y 
1490 ye=ve*x-«-vf*y+vg*z 
1500 ze=vi*x+vj*y+vk*z+vl 
1510 PROCperspect(xe,ye,ze) 

1520 ENDPROC 
1530 : 

1540 DEF PROCperspect (xe,ye,ze) 

1550 xs=dist!*xe/ze:ys=dist!*ye/ze 
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1560 ENDPROC 
1570 : 

1580 DEF PROCsetupcontrol 
1590 LOCAL N%,M%,Vertl,Counts 
1600 READ Vertices!, Patches! 

1610 DIM V(Vertices!,3),P(Patches!,3,3) 

1620 FOR N!-l TO Vertices! 

1630 READ Vert!,V(N!,l),V(N!,2),V(N!,3 

) 

1640 V(N!,1)-V(N!,1)*S:V(N!,2)«V(N!,2) 
*S:V(N!,3)«V(N!,3)*S 
1650 IF Vert!<>N! THEN PRINT"Error in 
table":END 
1660 NEXT 

1670 FOR Count!-l TO Patches! 

1680 FOR N!-0 TO 3 

1690 FOR M!«0 TO 3 

1700 READ P(Count!,N!,M!) 

1710 NEXT 
1720 NEXT 
1730 NEXT 
1740 ENDPROC 
1750 : 

1760 REM Define a single patch 


1770 REM Add more if you so desire 
1780 REM 16 vertices for one patch 


1790 DATA 16, 1 


1800 : 



1810 REM Vertex No, 

X, y, z 

1820 DATA 

1, 0.0, 

0.0, 0.0 

1830 DATA 

2, 0.0, 

0.8, 0.0 

1840 DATA 

3, 0.0, 

1.6, 0.4 

1850 DATA 

4, 0.0, 

2.4, 0.0 

1860 DATA 

5, 0.8, 

0.0, 0.0 

1870 DATA 

6, 0.8, 

0.8, 0.0 

1880 DATA 

7, 0.8, 

1.6, 0.0 

1890 DATA 

8, 0.8, 

2.4, 0.0 

1900 DATA 

9, 1.6, 

0.0, 1.0 

1910 DATA 

10, 1.6, 

0.8, 0.0 

1920 DATA 

11, 1.6, 

1.6, 0.0 

1930 DATA 

12, 1.6, 

2.4, 0.0 

1940 DATA 

13, 2.4, 

0.0, 0.0 

1950 DATA 

14, 2.4, 

0.8, -0.2 

1960 DATA 

15, 2.4, 

1.6, 0.0 

1970 DATA 

16, 2.4, 

2.4, 0.0 

1980 : 



1990 REM Define how patch is made 

2000 DATA 1,2,3,4,5, 

,6,7,8,9,10,11< 


14,15,16 IMW 


77je /Archimedes ypice Generator 

OTEACHINQ MUSIC oVOICES FOR MUSK 

OTEACHINQ SOUND oSOUND FOR GAMES/DEMOS 


Create an unlimited range of different sounds & instruments 
by means of harmonics, interpolation, enveloping, and morel 

' AVG provides on extensive rcmgo of tools with which to mcrnipulale sound After 
extensive use I oan oonfiim that this is a small price to pay for such a detailed 
piece of scitwora- ACX)RN USER (Feb '90) 

'AVG is an excellent padcage and does it's best to strike a bolonoe betwe«i 
complexity and versatility.... A sup^b ted for anyone wishing to experim«it witii 
sound sainples or waveform and envdope generation' 

MICRO USER (May'90) 

'AVG provides a tremendous wealth of facilities for VOICE oeation... I hove 
seldom seen a package which is so oomprdienslve and has so much to offer in 
its field' 

RISC USER (Jul'90) 

ALL FOR JUST £59.95 (JNC.?8cF) 

AvaMabie direct, orfromAVP or BEEBUQ (order code 5459). 


MJD SOFTWARE 

13 BURNHAM WAY 
LONDON W13 9YE 
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PipeDream 3 breaks down the barriers between word pnocessorj, spreadsheet and database^ Yon can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases^ 

Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeEheam 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3.11 i s fu lly mu I ti- laski ng and mul ti - windowing, so you can work o n ma n y docu ments a t once a nd i nslan lly 
move information between them. And since PipKzDream 3 can automatically toad and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 


Power, flexibility^ speed, ease of use. PipeDream 3, Breaking down the barriers* 

For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC CS and 1 Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Major features includci 

• many documents luddi^ at onca 

• inluitive RISC C3& user interface 

• displaying and printing 
of pictures Mithin tcKL 

• built-in 93,003 word 
spelling checker 

• file compatibiilEy with 
rc it ZSS PipeDream and 
fine View Professional 

« background racaleulaEian 

• keystroke campatibilify 
with Zfld ti pc PipeDream 

• ZSS filing ■system 


automafk loading of VIEW, 
ViewSheei, Lotus, First Word 
Flos, Tab and CSV files 
automaHc saving of VIEW, 
Lotus. Acorn DTP format. Tab 
and CSV files 
multi-field sorting 
use of all available fonts 
62 spreadsheet functions 
eKiemal refererKes for 3-D 
model Eing 
macro file recorder 
slot protection 


For a free btOchuic, complclc and return ihii ccupon 
PipeDicam 3 O View Pnorcsiionst D 

Name _ 

Address_ 


Post code 


Cohon Softwarr, Broadwiry Hotise,M9-151 Si, Ncois 
Road, Hardwick, Canihridgc CR3 7QJ, Rngtand. 


W54 21 TeP 0954 211472 


_I 


Ail I TV cVrl m fV arttn nlrtiWwria ffum PipKilrddm 3 la 2 mnd I Uwbnf J V frtrph 

Cdlton Software, Broadway House, 149’151 St. Neota Road, Hardwick, Cambridge, CB3 7Q], England. 
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Introducing C - 

Part 8: Command line arguments, dynamic 
memory aiiocation and bit variables. 

by Dec McSweaney 


COMMAND LINE ARGUMENTS 

The complex topic of using C to interface 
with the Desktop will be tackled at length in 
a forthcoming series of articles. In the 
meantime I will explain the more 
conventional way of invoking C programs* 
This involves typing the name of the 
program at the * prompt, for example: 

*a^zog axgl arg2 

This would cause the program ‘myprog^ 
to be loaded and run (provided it existed in 
the current directory or the library). ArgI 
and arg2 are 'command line arguments, 
which are passed to the program by the 
operating system. But how does the 
program get hold of them? 

Up to now, when example programs have 
appeared in this series, the function main 
has been followed by empty parentheses or 
the word void. However, main can have two 
arguments. The first is an argument count, 
the second an array of char pointers, each 
pointing to a word on the command line. By 
convention, these two arguments are known 
as urge and argv respectively, and who am I 
to fight convention? The full prototype of 
main now reads: 

<type> iDainCint arge, char *argv[]) 

where <type> would be 
void or int or whatever. 

The second argument, by 
the way, reads “an array 
argvlJ of type *char 
Mastering the art of 
interpreting complex 
declarations is an 
achievement of no small 
difficulty - take my advice 
and stick to the simple 
ones wherever possible)* 


contents of argvfO] will always be the 
program name as entered at the keyboard. 
This allows you to detect if the directory 
path was used, if you really want to know 
(and I dare say there's scope for a spot of 
software protection here). A word is defined 
as a string of characters bounded by 
unquoted white space. Thus; 

n^pcog hello sam /* arge « 3 */ 

but: 

aqfpEog "hello jpum" /* aigc = 2 */ 

Successive entries in argu[j will point to 
successive words on the command line. As 
with most things, C trusts the programmer 
to stay within the bounds of the array. And 
here we come to another rich source of 
errors in C programs; the number of 
arguments after the command line and 
subsequent program name {held in argv[Ol) 
is thus one less than arge as : the first 
effective argument is argvll] and the last is 
argv[argc-lj. Tve told you now, so don't 
blame met 

Here's a brief example of a program 
which takes arguments: 


/* calc,c " print! the result of erithEoetlc expxeiticm In */ 

/* srguAtnt* 1-3/ e*9* cnle 75 / 15 ifould print 5 */ 

/* IZrltten by Dec MCSweeney 1991 

linciude <stdio.h> 

finclude <etrlng.h>- 

finclude <atdlib*h> 

int iBain{int ergC/ char *ergT[]} 

{ 

int qpl/ Qp2; 
iflergc != 4) ( 

fprintf titderz/ "Wrong number of ergunentsSn'q; 

*iit(l); 

1 

« itol (argvll]) /' 

/* function atoi(itr} retuma int value of string */ 

Coni, overleaf 


arge will always be at 
least 1, in the case where 
the only word on the 
command line is the 
program name* Thus, the 
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op2 s atoi(argv[3]); 

•vitch(*argT[2]) ( 

CAM '•f*: 

prlntf ("IdVa", opl ♦ op2); 
br^ftk; 

CAM 

printfCldNn", opl - op2); 
bcAAk; 

CSAM '•»; 

pxlntf ("IdVn", opl * op2); 
bxAik; 

CAM •/': 

printf("IdVn", opl / op2); 

bTAAk; 

dAfAult: 

fprintf (AtdArx, ’'Unknown optrAtion"); 
brAAk; 

) 

) 


Note how the switch statement uses 
*argvf2], that is, the character pointed to by 
argv[2] (each entry in the array argvf / is a 
pointer of type char remember), while atoi 
takes as arguments the pointers themselves. 

If you’re getting the hang of C you could 
try amending the program to take real 
arguments, using cUof[) instead of atoi. The 
program ought to check argv[3] for zero 
before dividing, and if you can include sqt 
from part 1 you can have a gold star this 
month! 

The arguments above are positional^ 
that is they must appear in a fixed sequence 
and their meaning to the program is 
indicated by their position. More normally, 
at least some of the arguments will not be 
order-dependent and in the case of a 
program with many options could be quite 
numerous - think about writing a C version 
of the RISC OS ♦COPY command. 

The usual way to handle such a situation is 
to process each airgument in turn using a for 
loop: 

forfnsl; iKArgc; iH4) ( 

/* ... Argv[n] proosBaing .. */ 

) 

Observe that n starts at 1, but the 
terminating condition is n<argc, so the last 


iteration processes argvfargc-1]. For a 
command like ♦COPY the first two 
arguments would be positional (and 
compulsory), but the remainder could 
appear in any order. In such a case the 
program would validate for at least two 
arguments (argc >= 3) and the for loop 
would start at the first optional argument. 
Optional parameters should be set to their 
defaults first, then reset if mentioned in the 
command invocation. Mandatory 
parameters can be set to invalid values first, 
then checked for valid values after all the 
arguments have been processed. 

SOME USEFUL FUNCTIONS 

The standard C library contains a large 
number of useful functions. Many, such as 
the input and output routines, have 
already been discussed. One group of 
functions that has not been covered is 
concerned with the dynamic allocation of 
memory. 

In a multi-user operating system such as 
UNIX, or a multi-program environment 
such as RISC OS, it is important that 
programs do not take up more memory than 
necessary. If your word processor is to be 
used for a short letter, it doesn’t need 
enough memory to store a novel (1st Word 
Plus please note!). In the same way, it is 
frustrating if a program imposes 
unnecessary limitations on the user. One 
popular word processor runs on the IBM PC 
(a 640K machine), but will only cope with 
documents of up to 32K! 

The easiest way to cope with this 
problem is to provide the program with 
memory when it needs it, and to claim it 
back when the program finishes with it. The 
functions mallocO and freeO provide this 
facility. 

The full prototype of malloc is: 

void *mAlloc (BizAjb s); 

This means that malloc returns a pointer of 
type void. A void pointer is simply a 
mechanism for converting pointers from one 
type to another using casting. So, if the 
memory is required for a character array, 
the function would be called thus: 
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If malloc cannot claim suflicient space from 
the operating system it will return a null 
pointer. 

The structures discussed in part 6 are 
ideally suited to the use of malloc. A typical 
structure representing a block of text in a 
word processor might look like this: 

struct block ( 
char *taxt; 
struct *block prer; 
struct *block nszt; 

In¬ 
struct *block bptr; 

Tb claim more memory as extra lines are 
added: 


bptr->next ■ (struct block *)malloc(sissof(struct block)) 
/* liak tha n«v block to tha chain */ 
bptr->fiaxt->praT « bptr; 
bptr=bprt->fvaxt; 

l^r->ciazt ■ NOLL; /* this is tba and of tba chain */ 


chunk to service a request. 

Furthermore, Acorn’s implementation 
provides memory from the amount allocated 
in the program’s original Wimpslot. Once 
this is used up, malloc will return null 
pointers (implying no more memory), no 
matter how much there may actually be. 
RISC OS applications may use a family of 
functions found in flex.h and heap.h which 
sidestep these problems (but reduce 
portability). 

BIT VARIABLES 

If you use flags extensively in your 
programs and you’re coming from an 
assembler background, you might not like 
the idea of using a whole integer (4 bytes in 
Acomsofb C) to store a simple yes- 
no value. If your programs are 
huge, you might not have room! In 
a well designed language it should 
be possible to store a flag in a 
single bit, and this is true in C. 


Once the size of the block is established, 
malloc can be used to allocate the text area: 

sixejb block^size; 

bptr->text ■ (char *) malloc (block_sii«); 

To release a block of memory, the 
function free() is used: 


frM(bptr->t«zt); 

/* unliak from the chain */ 
bptr->ciazt->px«v a bptr->ciezt; 
bptr->pr«v->nBzt a bptr->prBv; free (bptr); 


One approach is to use i^define to set up 
bit-values. Returning to the ♦COPY 
example, options could be defined as powers 
of 2, corresponding to a bit: 

Idefine rORCIjDVKRIlRin 1 
Idefine DELEli_SOORCI 2 
ideflne VERBOS 4 

/* ... and eo on */ 

Int options; 

Tb set a flag, write: 


options |a VERBOSE; 


/t • I • Ib the bitwiie OR */ 
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lb unset it, use: 


options -VERBOSE? /* U' is th« bitwiw AKD */ 


This uses a new operator: the tilde C~) which 
means NOT in bitwise operations. Note also 
the use of the <op>= shorthand, 

Tb test such a flag, you would write: 

if ((options fi VEHiOSE) = 0) 

/* If VERBOSE Is off V 

However, C allows you to define a structure 
containing bit-fields: 

struct ( 

unsigned Int forcejoverwrite : 1; 
unsigned int delet«_souxoo : 1? 
unsigned int verbose : 1? 

1 copy_options? 

The width of the field in bits is specified 
by the number after the colon. In this 
example, copy^optians contains three one-bit 
fields which you can access in the same way 
as any other structure member* For 
example: 

copyjoptions. verbose = 1? 

if {copyjcptlons.deIete_eoiirce = 0) 

You should check your compiler's 
documentation for information about the 
way bit fields are implemented. Such factors 
as alignment and order of allocation will 
vary from one compiler to another. In 
Acornsoft C, for example, copy_option 3 
would occupy an int and force_over'Write 
would occupy the least significant bit. For 
the sake of portability you should not rely 
on a particular compiler's foibles. 

USING SWIs 

A feature of the Archimedes is the well 
documented interface to operating system 
routines. In Basic this is achieved with the 
SYS command, in assembler, SWI. Of 
course, C also provides a way of accessing 
them. Naturally enough, what follows is 
specific to RISC OS machines, and the 


names will be unique to the compiler - 
in this case AcornsofCs ANSI C 
release 3* The principles will apply to 
any compiler. 

A header file, kernelh, contains function 
prototypes, i^defines and other relevant 
data, but there are possibly better 
alternatives in RISC_OSLib (see the future 
series on programming the Wimp in C), 
which contains many ‘packaged' SWIs. 

Information is passed to and from SWI 
routines in the registers 0-9. These are 
defined as a structure _k€rnel_swi_regs in 
the kernel.h file. In your program you 
should include the following lines: 

iincltida <kemel.h> 

Jtetnel_Bifl_tega iay_y^a; 

Individual registers are treated as ints and 
accessed as in this example: 

iiyregB.r[4] ■ 1099; 

Registers are often used to hold the 
addresses of (or pointers to) character 
strings or other blocks of data. C is well- 
suited to this requirement. The address of 
any variable is given by the operator 8c, or 
in the case of arrays by the unsubscrip ted 
array name: 

di«r mesBage[50]; 
struct llnajdat* edit^llne; 

iiqf_regB*r[0] = (intlmeBwgfl; 

ny_regB.r[01 = (int)£edit_lln«; 

Pointers are cast as integers, which is the 
type of the register array elements. You can 
even pass the address of a “character 
constant” or "string literal”: 

ii^jregB.E[Dl » (int) "ThiB la m literal"; 

Tb actually call a SWI, use the routine 
Jternel^swU 
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Introducing C 


_kemel_s^ri(lnt »vi_ininb«r, Jcamel_Bwl_r€ga *1 ji, _kein«l_iifi_r»gi *oatl 


The SWI numbers are ^defined in swis.h so 
you can refer to them by their names, for 
ejcample: 

finclude <swiA,h> 

JceEnel flwiCOS ReedVirVil, toiy Eega, Amy^regs); 


This topic will be 
_ covered in con¬ 
siderably more 
detail in a forthcoming series on 
programming the Desktop in C* In the 
meantime, here is a short program to 
display any portion of the time/date 
display, in much the same way as the 
UNIX utility "date”. 


/** date.c - print any portion of the '"Tiina" musaga In any **/ 
/** ipecifiad fosnat (see PRM for key) **/ 

/** Kxao^fle’ data m> the %Dy%ST’’ would print **/ 

/** “^esday, Deoeniber the 25th” **/ 


/** l&de in England by Dec HcSweeney, progrszmiar to the gentry 

tinclude <8tdio.h> 

linclude <BtdIib.h> 

tinclude <kemel.b> 

linclude <cirie.h> 

int mainfint argc, char ♦aigv[]) 

{ 

char pblock[5]; 
char outatring[50]; 
int n; 

_kemel_*ifi_rigi r,' 

/** Firet a call to OS^fTord 14, 3 - read clock at 5"byte value **/ 
/«* rO = 14, rl « address of parameter block (to hold ztault) **/ 
/** on entry, 1st byte of rl Is set to 3 (the "reason code") **/ 

r.rlOjBlt? 
r, r [ 1 ] = (int) pblock ; 
pblockiOl ■ 3; 

^kemal^Bwi(OS^Jford, fir, fir); 

/** on exit, F^Iock bolds the 5-byte time - compare with a Basic **/ 
/** command "SYS 07, 14, pblock TO , pblock^ *»/ 

/** first we show the contents of pblock..., **/ 

forCnsO; n < 5; n-H-) 

prlnt£(^%023t ", pblodc[ii])? printf["\n-); 

/** Itow, we call SWI fiCl to convert. arg7[l] i* the Char array **/ 
/** bolding the format string. For this call the 5-byte block is ♦*/ 
/** addressed via rO, the output string via rl, the format 
/** string via r3. The length of output array is in r2, **f 

r,r[0]=r.r[lj; 

r ,r [1]=(int) out string; 

r.r[2]=50; 

r,r[3I = (int)argv[ll; _kemeI_swi(OS_ConvertDateAndrime, fir, fir); 

printf C" % s \n", out string); 

exit(O); 

) 


As it stands, the 
program will fall over 
if there is no format 
string in argvfl], and 
does no validation on. 
the format, so it relies 
on OS_ConvertDate 
AndTime to cope with 
arty rubbish the user 
might type. 

Now you know 
how to do it, why 
not change date.c to 
report an error if no 
argument is present, 
or even to use a 
default string 
clever types could 
use OS_ReadVarVal 
to access 

SYS$DateFormat, 
or call OS_Convert 
StandardDate 
AndTime (SYS &60) 
which uses 
SYS$DateFormat 
instead of r3, A really 
user-friendly version 
would print helpful 
information if argvfl] 
was missing, invalid or 
set to "T. 

Have fun! 


That's it for this 
month. Next time I 
hope to wrap up the 
series by tidying up a 
few loose ends and 
taking a look at the 
compiler. 
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MSRLEV E.LE.C.T.R. 



A3000 

410/1 

420/1 

440/1 


£599 

£1099 

£1699 

£2099 


Learning Curve £699 


rchimedes 


THE WORLDS 
MOST POWERFUL 
MICRO 

SPECIAL OFFER 
Buy an A3000 and get an 
extra 1 MB RAM fitted for 
only £50 or a free A3000 
Analogue & User Port 
Podule. Buy a 410 and get 
an extra 1 MB RAM free 


ARCHIMEDES PERIPHERALS 

Colour Monitor 

£199 

300/400 SERIES 


Mono Monitor 

£73 

Acorn Rom Podule 

£56 

A3000 


2 Slot Backplane 

£37 

Monitor Stand 

£29 

4 Slot Backplane 

£59 

User Port & Midi Pod. £49 

I/O Podule 

£80 

Serial Upgrade 

£19 

Midi Podule 

£65 

Econet Upgrade 

£49 

Second 3.5’ Drive 

£115 


ARCHIMEDES SOFTWARE 


Pipedream3 £147 

RiscOs Companion £49 
1st Word 4- £69 

Autodesk CAD £79 

Acorn PC Emulator £99 
Acorn Desktop Pub £149 
Clares ProArtisan £145 
Clares Artisan £29 

Clares Toolkit £34 

Clares Toolkit 4^ £43 


This is a small 
selection of the 
software that we 
can supply at 
competitive prices. 
Please call for 
any item you 
require. 


TELETEXT 


THE BIGGEST 
SELLING ADAPTER 

The Mortey Teletext Adapter 
is novr available for the 
Archimedes. Adverted 
specifications, irKlude digital 
tuning, screen dumps etc. 
Connects via the external 
podule socket or our 
Analogue/User Port £125 



Existing users of our BBC 
Teletext Adapter can have 
the unit converted to an 
Archimedes version for£35 


FURTHER INFORMATION 

Our new catalogue will be available from mid August. We 
can also supply data sheets for most products. Please call 
or write if you require any of these. 


NEW IN STOCK 


MICROVITEC 

CUB3000 

MONITOR 

£199 

INCLUDING 

CABLES 


This is the new monitor from Microvitec that has been specialty 
designed for use with all Archimedes computers. It comes 
in a rugged colour matched metal case with controls for 
brightness, contrast and volume. The picture quality is very 
good and all the required cables are included in the price. 



A3000 3.5" 
SECOND DRIVE 



The kit consists of a 3.5 
inch floppy disc drive, data 
cable, power cable, metal 
case (cream coloured), an 
interface carrier board and 


full fitting instructions. 
You will be required to take 
the current drive out of the 
A3000 and replace it with 
the interface carrier board 
(unlike some add-on drives, 
you can still use your internal 
podule socket). The original 
drive then fixes in the case 
with the second drive and 
the case is connected to 
the A30(X) with two cables. 
As the connectors are 
detachable, the unit can be 
easily disconnected from the 
computer if the need arises. 

£125 


The kit and assembly are 
similar to our 3.5" kit except 
the case is larger and the 
mechanism is a high quality 
TEAC 5.25" drive. The drive 
(unlike some you can buy) 
is also buffered to Acorn 
specifications so eliminating 
the possibility of damage to 
your A3000 (buffering is not 
required for an additional 3.5" 
drive). 

£169 


A3000 5.25" 
SECOND DRIVE 



LEADS & MISC. HARDWARE 


SCART Monitor Lead 

£8 

80 col Printer Stand 

£15 

9 Way Msync Lead 

£8 

132 col Printer Stand 

£19 

Arch Serial Lead 

£8 

A3000 Monitor Stand £29 

Printer Lead 

£6 

Tilt & Swivel Stand 

£11 

2 to 1 Printer switch 

£20 

Eprom Eraser 

£18 

3 to 1 Printer switch 

£30 

Eraser with Timer 

£23 

4 to 1 Printer switch 

£36 

5.25" Discs X 10 

£5 

64k Printer Buffer 

£115 

3.5" Discs X 10 

£10 

256k Printer Buffer 

£199 

27128 Eproms £4.20 













































O.N.I.C.S. L.T.D 


MEMORY EXPANSION 

THE BEST VALUE MEMORY UPGRADES 


UnUko most other upgrades^ oar 1MB 
upgradeable card can be upgraded 
wfth another 2MB i4MB total in 
machine^ at a tater date for maKknum 
iiexibithy, Futhermore^ our card can he 
upgraded without throwing away the 
memory that you already have on the 
card. 


A3000 1 MB Expandable £93 

A3000 1 MB Non-Expandable £83 

A3(K)0 3 MB Upgrade £2S9 

A3000 1 MB to 3 MS (free fitting} £180 
305 1/2 MB £89 

400 Series 1 MB £93 

400 Series 3 MB £249 



- Fully campatible with all Acorn software. 

- A must for all serious Archimedes owners. 

- Make full use of powerful RISC-OS packages. 

- Cart use extra RAM as a second drive. 


*** NEW PRODUCT *** 

A3000 BBC Analogue + User Port Podule 





Full Specification BBC analogue and user 
port. The analogue port is accessible 
using AOVAL from BASICS with all 
BBC OSbyte calls supported. 

£69 

Interface software written bf 
Acorn for maximunt 
compatibWty with the BBC. 


ARCHIMEDES HARD DISK DRIVES 


*** NEW ^ 

A3000 HARD DISK DRIVE UNIT 


SCSI HARD 
DISK DRIVES 


INTERFACE 


INTERFACES 


ST506 Podule Kit £149 

DISK DRIVES 

Including ST506 Podule, 
cased drive with power 
supply, cable & leads 

20MB £339 

40MB £499 

Larger Drives PDA 

Compat/bfe with Acorn's ADFS. IB hit 
interface for extra speetf. Drive mounted 
in separate coiour coordinated case with 
switched mode power supply and fan. 
Compiies with Acorn's new 
recorntnendations on BF emissions. 



A3000 SCSI Pod. £143 

300/400 SCSI Pod. £199 

SCSI DISK DRIVES 

Including SCSI Podule, 
drive, cable S leads. 
A3000 drives also 
include case and power 
supply. 

A3000 20MB £485 

A3000 30MB £495 

A3000 40MB £575 

300/400 20MB £449 

300/400 30MB £489 

300/400 40M8 £569 

PJease call for prices on 
larger drives for A3000 
or 300/400 


MfiRLEV 

ELE.C.t.R.O.N.LaS. L.TD 

Morley House 
West Chifton 
Noflh Shields 
Tyne & Wear 
NE29 7TY 

Tel (091} 257 6355 
Fax (091} 257 6373 

Shop hours: 

9 am to 5:30pm {Mon- 
Fri) 9am to 4pm (Sat) 

Acorn^ 

We are an Acorn dealer and 
service centre. Ifyouwcuid 
like to have a look at the 
A3000 or any other Acorn/ 
Morley product please feel 
free to call in and discuss 
your requirennents with our 
staff. 


// there is 
anything you 
require which isn't 
advertised^ piease 
ring for a 
competitive 
quote. 

How To Order,,.. 

SV POST: Enclose cheque 
made payable to MORLEY 
ELECTRONICS LTD. 

BY PHONE: By quoting your 
ACCESS or VISA card 
number. 

CARRIAGE: El on most 
ardars. £3 on larger Items. 
Hard Disks, Computers + 
Monitors E10 (carrier). 

VAT: LIK custemers please 
add 15% to cost incl. 
carriage. 

GOODS USUALLY 
DESPATCHED BY RETURN. 

Government and Education 
ordors welcom'S. 

Acorn and Archimedes are 
trademarks of Acorn 
Computerg Lid. 
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INSTANT SPRITE DISPLAY 

Lee Calcm^ 

When editing an application sprite, yon can 
have trouble seeing the effect of your work. 
Even once you have saved the new sprite, the 
old one will still be displayed as the icon for 
your application in its directory viewer. This is 
because the Wimp sprite pool still holds a copy 
of the unedited sprite. 

To update the Wimp sprite pool (without having 
to resort to a hard Break), use FI2 to get to the 
command line star prompt, and issue: 

*IconSprites <pathnairije> 
where <patkname> is the full path to the 
application's [Sprites file, for example 
adfs:.^.$JMyApp.!Sprites. The new image will 
appear as soon as you return to the Desktop 
(by pressing Return). 

SHELLCLIINUSE 

Matthew Astiey 

On some occasions, the ShellCLI module (which 
allows you to invoke a command shell from a 
Wimp program) can give the error "ShellCLI tn 
use", and is unusable until after the next reset. 
There does not seem to be any way of retrieving 
it, but an alternative is available - from the 
Task Manager, select New task from the menu 
and enter the star command you wish to issue. 
This can either be a one-off command, such as a 
compilation command or disc catalogue 
command, or a *GOS to go to the Supervisor, 
This is like the ShellCLI, except that you have 
to exit with *Quit. 

USING AUASSSHELLCU 

MaUhew AsUey 

The key Pi2 from the Desktop can be put to 
other uses. Whenever it is pressed, the Task 
Manager issues a *ShellCLL If the system 
variable Alias$SheUCLJ is set, that command 
is used. For example: 

*Set Mias$ShellCLI FX 13B 0 l30|MlShel 
ICLIIM 

would “press" key r2 and then go into the 
ShellCLI as normal, but the string contained 
in Key$2 will be “typed" for you. If the 
ShellCLI is in use, or you prefer to go into 
Basic when you press FI 2, use: 

*Set Mias$ShellCLI Echo ||2M_||@n^ 

I IJiMBasiciM 

The Echo command (up to the first I M) puts a 
blank line at the bottom of the screen (but also 
creates a dialogue window in the middle of the 
screen), and then jumps into Basic. QUIT from 


Basic wiE give the usual “Press SPACE or click 
mouse to continue" message. The command 
*%ShellCLI sends the ShellCLI command to 
the original ShellCLI module, as in the first 
example. 

MORE USES FOR ADJUST 

Lee Catcraft 

If you click on the title bar of a window with the 
Adjust button, you can move the window around 
without bringing it to the front of the stack. 
Moreover you can continue to move a window 
beneath another even though you cannot see the 
vrindow that you are moving. Ai^ust can also be 
used on the adjust size icon without bringing 
the window to the top of the stack, 

FONTS AND VOICES 

Tony Shew 

The RISC User monthly disc for Volume 3 
Issue 3 contained several system fonts, and 
many more can be obtained "free" by searching 
through games discs (but you must not 
contravene copyright by distributing these). 
The filetype may need to be changed to FF7 
(BBC font). Games discs are also a good source 
of sound voice modules. 

SUB-MENUS IN C 

David Spencer 

If you are using the ANSI C compiler with 
RISC OS Lib to create a menu tree involving 
more than two levels of menu, you must attach 
the sub-menus in reverse order. For example if 
you have a tree of the form: 

Menu 

Sub-menu level 1 
Sub-msrm level 2 

you must attach the level 2 sub-mei;u before 
attaching the level 1 sub-menu, or the task will 
misbehave when the menus are opened. 

PRINT TO FILE 

A tan Wrigiey 

OS_Byte 5 (or *FX5,n) sets the driver l^e for 
subsequent printer output (this can also be 
configured using ^Configure Print n). The 
second parameter of the call, or the value of n in 
the *Conligure command, is 1 for the parallel 
port and 2 for the serial port, just as on the BBC 
micro. However, if this parameter is greater 
than 2, RISC OS looks for a system variable 
with the name Pnnier7)^pe$n (for example, the 
NetPrint module defines PrinterType$4). To 
divert printer output to a file therefore, set up a 
variable as in the following example: 
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. *Set PrinterType$5 adfs::HardDisc.$.Odd 
bits.Printout 

Then use *FX5i5 to send any subsequent 
printer output to the specified file. This is very 
useful for testing printed output from your 
programs without generating reams of scrap 
paper The file thus produced can he loaded 
into Edit for inapection- 

DRAWING STRAIGHT LINES 

Ivor Ciarke 

Drawing a straight line in Movie Maker, or 
indeed any drawing package in freehand mode, 
can be very tricky. However, by running the 
mouse along the ^ge of a box, a straight line 
can be drawn quite easily Diagonal fines can 
be drawn by using the comer of the mouse on 
the straight edge. 

CONDITIONAL FUNCTION 
EXECUTION INC 

Leo Cstcraft 

In C the following fine will only cause myfancO 
to be executed if flag is false: 

if (flag II myfuncO) i++; 

The contrary is true in Bask: 

IF flag OR FNmyfunc THEN i+=l 
Here FNmyfuru: will be executed regardless of 
whether its value is to be used or not. Here C 
appears bo behave more efficiently than Basic, 
since H flag is TRUE, the value of FNmyfunc is 
irrelevant. 

A similar thing occurs with the AND operator: 

if (flag Sik i++J j++; 

Here i will only be incremented if flag is 
TRUE, since only in that case is there any 
need to look at i at all. Again Basic will look at 
all the elements in the logical expression. 

IMPROVING PRINTERDM FOR THE 
STARLC24 

A.E Tayior 

Using the Star LC24-10 printer with DTP 
packages and also with Draw, I noticed an 


occasional and apparently random mis¬ 
registration between successive passes of the 
print head, producing a “slewing® of the fine of 
text. I was using PrinterDM with the printer 
definition set to Epson LQ800 {the LC24 
claims LQSOO compatibility). Eventually I 
traced the problem to a slight incompatibility 
between the LC24 and the LQBOf). 

This can be cured by a small amendment to the 
PrData file, under the section for Epson LQ800 
compatible (360 x 18Q dpi). Simply amend the 
following fine: 

1 ine_epi logue " <2 7 >S<0 >< 0x2 7 >J<2 4 > " 
to read instead: 

Une epilogne ''<27>A<0><13><27>2<27>J<2 
4>" 

OPENOUTAND FILETYPES 

tee Caicraft 

It is sometimes convenient to set the type of a 
file used with, the OPENOUT statement, and 
to do so before the file has been closed. Th do 
this, create a file of the required name, and set 
its type using *SetType (or combine both 
operations with SYS “OS_File”,lO), then use 
OPENOUT with the same filename. The fifing 
system will open the new file using the file 
type used by the previous incarnation. 

FASTMOVE 

Leonard Hanson 

The FastMove module supplied on the 
magazine disc for Volume 3 Issue 7 is very 
useful for hard disc users. If you use the RISC 
User Dustbin, open up the IDustbin directory 
and add the following line at the start of the 
!Run file: 

EMEnsure FastMove 0 RMLoad <ObeySDir>.F 
Hove 

Then save the FastMove module in the 
! Dustbin directory as FMove, This change will 
reduce the time taken when deleting files, 
since Dustbin moves files by •COPYing with 
the delete option set. 


• POINTS ARISING • POINTSARISING • POINTSARISING • 


PCOL 

Volume 3 Issue 5 (disc) 

Under rare circumstances, mostly with some 
longer programs, a fatal crash occurs when 
using PCol. An updated version of PGol, 
which will cure this problem, is included on 
this months magazine disc. 


Introducing C (Part 8) 

Volume 4 Issue 3 

Note that the concluding element of the for 
loop on page 62 should be n- - {and not n- as 
it appeared - a result of subsequent 
processing). 
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ARE YOU GOOD ENOUGH? 

As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 

If you have written any prograrro, completed or not, then we would like 

to hear from you. 

If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you, 

If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 

Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that It is needed. BASIC on the Archimedes Is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats oil we are interested in. 
Why not join the top team on ttie Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and Invitations to 
our informal programmers seminars. 

The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 

Please write, in confidence, to Mr. D. Clare at: 

Clares Micro Supplies, 

98 Middlewich Road, 

Northwich, 

CHESHIRE CW9 7DA 

If you have a progrom either complete or in development then please 
enclose a copy for our evaluation. 

To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 

Act today and become part of the leading software team producing 
software for the worlds fastest micro. 










Postbag 


GAMES 

In response to MrMraig's letter on adventure 
games (RISC User Mblume 4 Issue 2), please 
note that Magnetic Scrolls are alive and well 
on 071-403 4268 (they even answer the 
telephone as Magnetic Scrolls). With regard 
to the fatal bug in The Pawn it does exist, or 
at least it used to, as it has now been 
corrected. Users can send the original disc 
back to the publiskerSt Intermediates, 
P.O.Box 847, HarloWy Essex CM21 9PH, tel 
(0279) 600204 fora replacement. 

One problem which persists, and which I 
hope Magnetic Scrolls has taken heed of is 
that whenever the copy protection system 
asks for the word Kerovnia (probably once 
in every four times), it pretends not to 
understand the word, so saving fairly 
regularly is a good precaution. 

Mr.Craig does not mention any problems 
with Guild of Thieves, but 1 know for 
certain that there were a few which have 
been ironed out. The same rules for a 
replacement apply here as for The Pawn. 
One problem with all Magnetic Scrolls games 
to date is that they will not work with later 
versions of the C library module CLib than 
that supplied with the game. A simple 
solution is to press F12 and type: 

RMKill SharedCLibrary 
before running either game. Experienced 
users could probably alter the IRun file 
appropriately. 

With regard to the problems in completing 
the game, do not telephone Magnetic Scrolls 
because they enjoy keeping the solutions a 
secret Do not write to nte either because Tm 
not good at them. Instead Join Official 
Secrets, This is a club primarily for 
Adventurers and is part of Intermediates. 
Club members enjoy the benefit of an 
adventure help line, and other assistance. 
The cost is £29.99 which includes a quarterly 
magazine, a bi-monthly glossy catalogue 
covering all games, and a choice of game 
from Fish!, Corruption, The Pawn, or 
Guild of Thieves. There is also a lower 
price Special Reserve membership without 
the help line for £6.00. 


-As a final note, watch out fbr Wonder^Land 
early this year. Magnetic Scrolls" new 
adventure being published by Ylrgin. 

Nicholas Furness 

AND MORE GAMES 

Just a short letter to congratulate the writers 
of TluinWorld. What a masterpiece! The game 
is a Joy to play from start to finish. Each 
evening when I get in from work I load up 
the game and try to improve on my final 
score of 559B0. Never has such a great game 
been written for the Acorn range of machines. 
If this is what the standard of games 
programs on the Amiga is like, then where 
have the writers of Archimedes games gone 
wrong? 

Please, please, please can we have more 
games like this for the Archintedes. No time 
for any more, I still have the world to save! 

NbH Newman 

GERMANIA 

Alan Wrighey's article in RISC User Wilume 3 
Issue 10 is misleading with respect to the 
German keyboard. Every week my wife writes 
long letters to her mother in Germany. After 
loading 1st Word Plus, she presses F12 and 
types (at the star prompt): 

COUHTRY GERMMY 

Not only do the Z and Y change places but 
the entire keyboard adopts the German 
layout. The is to the right of zero, U to the 
right of P, and 0 and A to the right of L. For 
a German touch typist there is no further 
problem. 7b change back to the normal state 
type: 

COUNTRY UK 

at the command line prompt, being careful 
not to type ‘COUNTRY". Altematively, simply 
reboot the machine. 

David Taylor 

Alan Whgley replies, "Mr.Taylor ts quite right 
about German characters. I thought I had 
tested both French and German before writing 
that particular paragraph in my article, but 
obviously I only tried it out with the French 
alphabet, which dees not have provision for 
accents on the keyboard. 
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Personal Ads (free to members) 


SlO odhvr with 4Mb RAM and 40 
Mb hard disc, OC EOMRAM 
Acorn ANSI ‘C\ Programmers 
Reference manuals and software 
£1600. m (02583 4S281 exIiL 2209 
between 0900-1700. 

Stoiy writing, artnfida] creataviiy. 
Postal discussion/programming 
group proposed. Tony Kelly, Can y 
Lloer, Ffarmeis, Llanwrda, E^ded^ 

C^non PW1080-A printer as new 
with cable (cost £270) £90 plus 
carriage. Tel (0275) 462979. 

Archimedes A3000 base with 
1Mb RAM and RISC OS, 3.5'^ 
floppy drive etc. for only £650 
(unwanted gift 1 month old!) Tel. 
(02463435555. 

Games Minipack NaJ2 from CIS. 
contains Corruption, Conqueror 
and Quaaer. NB these are originals 
not copies (unwanted gift) £11 the 
kt Tel. 081-654 3733. 


BBC B & Torch twin disc system 
with many packages, discs, 
magazines, books, cassette unit 
and li^bpen etc. £250. Tel. (0304) 
853267. 

ArchiiiiedeB 310 base unit with 
RISC OS, manuals, applications 
discs, 4 dot podule backplaT>e £450. 
Tel (058 2833 3773. 

Archimedea 310 computer with 
twin disc drive, cokur monitor and 
software £600. Tel. (0743) 248107. 

Epson L^2500 24 pin dot matrix 
printer with dual bin sheet feeder 
bargain at £350. Tel. OSl-631 OTlft 

Archimedes 410/1 8Mb RAM, 
50Mb bard disc, Geniacan AS mono 
scanner, Taxan 795 monitor with 
VIDC, Linnet modem, manuals, 
lots of software. Offers in the region 
of £2200. WiD split, also Cumana 
5.25" disc drives and modems £20 
each. Tel 04867 80632. 


Philips paper-white monitor, 
model BM7522, excellent condition 
with original packaging £55. Tel 
061-969 9428. 

Complete worimtatioii 1200mm 
bench, Master 128, colour monitor, 
LX800 printer, twin 5.25" Cumana 
drive, perfect condition £650. Tel 
081^64 8276. 

Micro Peripherals MP165 
printer with NI^ facility, Epson 
compatible, hardly used (home 
environment only), complete svith 
leads and manual etc. £100. Tel 
(0508633517. 

Archimedes A3000 still under 
warranty, new games, manuals, 
software and magazines £575. Tel 
051-489 9456. 

WANTED: Acorn Atom computer 
in good working condition. Tel. 091- 
374 3631 day, 091 -372 1 797 eves. 


IPersonal Accounts 

ASOOO/Arc Special Edition 

Version 2 : £28.95 


* RiscOS Multi-Tasking Application 

* 23 Automatic Standing Orders/Any Period 

* 48 income/Paymenl Headings with budget columns 

* 10 BankA^redit/Cash Accounts on-line 

* 20 Quick Entry ftc-sets 

* 3000 Entries per File 

* 50 Character Description Space 

* Full Scrolling Entries for easy inpiit/edit/search 

* Reports to Screen/Printer/File 

* Caiculaior/Note Pad/Autosave & Much More 

"Personal Accounts is very powerful, good value for 
money, easy to use and comes highly recommended" 
Review of Version 1, Archive, November 1990 


Apricote Studios 

2 Purls Bridge Furih. Mancu, Omihs, PEI 5 OND 

Tel: 035 478 432 


Cambridge International Software Ltd 
8 Herb rati d St London WCIN IHZ 
071 833 4023 

ArcMonitor £24.95 

Professional disassembler, 10 breakpoints, 
mouse driven, RM, + many features. 
Supersounds £17.95 

4 disks of 'raw' samples 
Minipack 5 £29.95 

contains HSH, PON Sc FIREBALL II 
Mah-Jong Patience £1995 

Fiendish version of Chinese patience with tiles. 
MicroDrive £19.95 

Much acclaimed 3D golf simulator. 

Crisis £17.95 

Maze game full of 'mlcons' and sounds. 

PIPP £49.95 

Cross-curricular project plarmer for Primary 
schools. Contains ALL AT .statements. 
RiscType £19.95 

Archimedes Typing Tutor 
Fireball n £19.95 

World's greatest breakout game. 

VAT itidudedplease add £1 p AH cards accepted. 
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Technical Queries 


CREATING BOOT FILES 

Dear Sir, 

/ have typed in a tot of your utilftfes 
and now have around 20 of them. The 
icon tar gets so full that / have to scroll 
a sideways to access everything. Is It 
possible to create a second Icon bar 
which I can bring up by ciicking on the 
original icon bar? 

Still on those utilities, 1 have to load 
them off my "system* disc every time I 
switch on. l have used iBoot Obey flies 
with things like: 

*Desktgp Hun IMous# 

and that works fine, tor the first utiiity 
Playing about with the IBoot file, I can 
get nothing more to happen. How do t 
get it to load, say, 20 Wimp programs 
and enter the Desktop property? 

Richard Murray 

First of all, it is just not possible to create 
another icon bar. It is possible to change 
the height of the existing icon bar, but tJiis 
still doesn’t help as all applications so 
installed must occupy a unique position 
along the length of the icon bar. 

However, it is perfectly possible to create a 
boot system which will achieve what you 
seek, and load and install 20 Wimp 
programs leaving you in the Desktop, but 
this cannot be done with a single file. 
What you need to do is to create an 
application on your ‘system’ disc called 
IBoot* Next use Edit to create a !Run file, 
to be saved in this application directory. 
Use this to set up any system variables (to 
set font path, run types etc*), and then 
enter as the last line of the IRun file: 

Desktop -file <Boot$Dir>*DesJcboot 
assuming that Boot$Dir has been set to 
<Obey$Dir> earlier. 

Then create a text file (filetype FFF) called 
DeskBoot with lines similar to: 

Run adfs: :SysteinDise.$* [Edit 
Run adfsr :SystemDisc.$.!Paint 
Run adf s::Sys t emDis c * $,!Draw 
etc. 


finishing off with the line: 

FilerjOpenDir adfs: :Syste[nDisc.$ 
if you want to finish with the directory 
viewer for the root directory open on the 
Desktop. Finally don’t forget to set the 
anto-boot option on the disc to: 

*OPT4,2 

Alan Wrigley 

RISC OS EXTRAS 

Dear Sir, 

My investigations revealed the 
ReadMe fife in the ISystem directory of 
the Volume $ Special Disc which refers 
to RtSC OS 2.00 Extras. I checked to 
find if these had been reviewed in RISC 
User but could find no reference. What 
emphasis do you place on having these 
"Extras' Instailed? 

Geoff Steeper 

Where newer versions of modules or 
additional modules are required we 
include an appropriate copy of ISystem on 
RISC User magazine discs, and other discs 
(like the Volume 3 Special Disc) which we 
publish. A condition of Acorn allowing this 
is that the HeadMe file referred to by 
Mr. Steeper has to be included, though not 
all the items referred to are themselves 
included. 

Effectively, these extras are updated 
versions of some of the applications and 
other modules supplied on the Applications 
discs with any Archimedes, By and large, 
if you are not encountering any problems 
then there is no great incentive to upgrade. 
The extras were referred to briefly in RISC 
User Volume 2 Issue 10, and published 
(with Acorn’s permission) on the RISC 
User magazine discs for Volume 3 Issues 1 
& 2. They are also available through SID, 
Acorn’s on-line bulletin board, and on the 
RISC OS Extras disc from BEEBUG for 
£4.40 plus 60p p&p* In addition, as already 
stated, the latest modules from ISystem 
are often included on other discs when 
required. 

Mike Williams 
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Software for 




ShowPage is a PostScript compatible 
interpreter running under RISC OS. 

Over the last 6 years PastScript has 
established itself as an industry standard 
graphics programming language. 
Pioneered by Adobe for use in the 
original Apple laser printers, it is now 
used in all manner of output devices 
such as colour printers, and typ>esetting 
machines. 

ShowPage will be attractive to those 
wanting to learn and explore this 
programming language and those 
wanting to print and use PostScript files 
from other machines. 

ShowPage is fully multi-tasking and 
RISC OS compatible. It can read any 
PostScript file and output either to a 
window on screen, or to the currently 
selected RISC OS printer. It can 
therefore be used to make even the 
lowest cost dot-matrix printer PostScript 
compatible. When used in conjunction 
with LaserDirect, it can turn this printer 
into a very fast and fully fledged 
PostScript compatible laser printer. 

ShowPage supports the colour 
extensions and can create a sprite file of 
any required size. It can therefore be 
used to incorporate PostScript graphics 
into other RISC OS applications. It uses 
the RISC OS outline fonts, rather than 
the conventional PostScript fonts, for all 


Package imcluties a spiral bounii manual detailing the 
ShowPage version of the language. 320 page PostScript 
language reference manual Adobe. 240 page PostScript 
language tutorial manual by Adobe. Discs containing 
ShowPage and example programs. AvantG, BookM, 
Pembroke RISC OS outline fonts. 


rendering, so it is 
compatible with the 
wide range of Archimedes outline fonts 
now available for this computer. 

ShowPage has a simple built in editor 
allowing PostScript programs to be entered 
directly, and interactively with the results 
shown on screen in another window. 

Showpage is compatible with the 
output from Acorn PostScript printer 
drivers. Minimum recommended memory is 
2Mbytes. 

£149-^ VAT (1171.35 inct) 


PostScnpt u a trademark of Adobe Systems Inc 




























the Archimedes 



An equation building tool that 
complements many RISC OS applications, in 
particular DTP and word processor programs 
such as Impression and Impression Junior. 

Many users of the Archimedes have a 
need to include complex mathematical 
formulae or equations into documents. 
Equasor allows equations to be built up on 
screen, graphically, from their component 
parts. Using the Accjrn outline font system it 
presents a totally accurate view of the final 
equation at all limes. 

It simplifies the building of equations by 
presenting palettes of symbols, funaions and 
operators which can be selected just by 
clicking with the mouse. It intelligently scales 
and re-si 2 es features such as summation 
symbols, brackets, and square roots as the 
equation is edited so they are always the right 
size. 

Once the equation has been created it 
can be saved or exported to any number of 
compatible RISC OS applications. In DTP 
packages it can be dropped into frames just 
like any other drawing where it can then be 
scaled and positioned as required. 

When used in conjunction with 
Impression II, it can take advantage of the 


equations into the text, even on the line. 
Once embedded in this way, the equation 
will then flow with the text as pan of the 
text. 



Multi-tasking RISC OS application. Supports 
direct in-memory transfer of equations for the 
fastest, simplest integration w^ith other RISC 
OS applications. Any number of equations can 
be handled at the same time. Equations can 
be viewed and edited at any scale. Saves 
equations as Drawfiies compatible with all 
applications that support this format. Supports 
multiple different RISC OS outline fonts and so 
is not limited to the Math/Greek font supplied, 

• Supports region selectJon and cut, copy, 
paste between equations and 
documents. 

• Styles for global control over fonts, size, 
spacing etc. of variables and 
operators .Effects give additional control 
over the appearance of individual parts 
of an equation. 

• Small, compact program perfectly 
suitable for 1 Mbyte machines. 

pachuge inclu^ies a 60 page spiral Itouitif 
mantiol witfj itetafled lutorlai re/erencef and 
index, Dises tnctuile the program, exampie 
equations, and Matb/Greek outline font,. 


£49+VAT (156.35indj 


ISl 

ComputEr Concepts Ltd 


Gaddesden Place • Hemel Hempstead • Herts • HP2 6EX • Tel. 0442 63933 • Fax 0442 231632. 
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RISC USER MAGAZINE DISC CONTENTS 


Belter Curves 


PBOCRAMSfNmSC USER MARCH mt 
Desktop Zoom 


Desktop as you wish 
Hard Disc Archiyer 

Ao excettent uUkty Hrr seiectmiy tacking up the contents ofy 
disc onto Poppies 

Watchdog Update 

An enhanced itersbn of the updated program described in the 
magazine giving added protection to your discs against viruses ai 
other ma/p^kes 

Creating Professhnai Disc Labels with Draw 

Sampie Draw Pies showing what can be achiei^, and which can b 
used as tempiates for other designs 
ffeeSh^ 

Use this program to aiiow the Task Manager to disp/ay continuousiy 
updated information on avaiiabie Pee memory 

Mastering Hfe HPmp (Part f$} 

A demonstration of more efPdent techniques for window redraws 
A ^rst Look at Bezier Curves (Parti) 

Three programs to experiment with as descnbedin the magazine, 
together with the data for the so<aiied Utah teapot 

Introducing C (Part 8) 

Source andcompHed versions of two example Cprograms described in 
this issue. 


ADDmONAL PROGRAMS DESCRIBED m THE MAGAZINE 

WP/DJP: Using the IBM Character Set with 1st Word Plus 

The data Pie for the BM character dePnitions together with 
corresponding LCIO and 104printer drivers andmodiPed Bun Pie to 
use IBM characters in fst mrd Pius 



BONUSiTEMS 

Acorn ^ New Printer Drivers 

The other two printer driimrs (referred to fast month): PrinterLJ and 
PrinterPS 

Desktop Toilet 

A novel appi/cat/bn with appropriate sound effects aiiowing you to 
Push away any unwanted Pies 
Multi-column Program Lister 

An updated version of this popular application which cures an obscure 
bug affecting the fisting of longer programs 
Font Control 

An appikaPan from Acorn's Roger Wilson aiiowing you to create a bit¬ 
mapped font for a given font size (for speed of access) and to change 
the values Par the fontmax andFontrmxt to FcmtmaxSparameters 


Disc Labels vdth Draw 








special Offers to RISC User Members - Mar 1991 


Each month RISC User will include a list of special prices for BEEBUG's own Archimedes software, 
available only to RISC User members. 


Code 

Product Members* Price inc.VAT 

14060 

yolume 3 Special Disc 


1 PDAl 

Desktop Applications 

9.95 

PAOM 

ArcOnnnIbus Gomes 

9,95 

PAS3a 

ArcScon III (complete) 

14,95 

PAUSo 

AfcScon III (upgrade) 

(on return of ArcScon EE disc) 

4.75 

1410a 

Rise User Movie Maker 

475 

1401a 

RISC User Toolbox (Arch.) 

5.76 

2420b 

RISC User Binders 

4.20 

0102b 

DFS reader 

9.90 


Code 

Product Members* Price 

TJlD4a 

DPS Reader RISC US upgrade 

Z3(r 

0106c 

Hard Disc Companion 

35.00 

OlOld 

Hearsay 

61.76 

0103a 

Hearsay RISC OS upgrade 

4.40 

0107c 

ISO C Dev. System 

79.00 

0100c 

Masterfile Archimedes 

16.50 

onib 

Outline Font Pack 1 

49.50 

OlOSd 

Ovation (Beebug DTP) 

99.00 

0796c 

Serial Link 

17,25 

0105a 

Serial Link RISC OS upgrade 

2.40 


OTHER MEMBERS' OFFERS 

These offers are available for one month from publication. 




Ancestry (Minerva) 


Offer price £52.00 (Inc VAT) + £1.50 p&p 

(Save over £14.00 on normal BEEBUG price) 


This popular application From Minerva allows you 
to build up family history data, including scanned 
images where appropriate, for display and 
printout. 


Stock Code 0957b 


Sale of Laser Printers 


We have a number of 
ex'demonstratlon Qume and 
Panasonic Laser printers available at 
highly reduced prices. 

Please phone for up to date 
information on prices and 
availability: 

SL Albans (0727) 40303 


10 X 3-5" Beebug discs 
in library case 


Offer price £7.95 Cine VAT) + £0.60 p&p 

(Save £3.50 on normal BEEBUG price) 


High quality 3-5" discs from a well known 
manufacturer supplied complete in a smart and 
convenient case. 


Stock Code 0675a 


ABC Compiler (Dabs Press) 


- 


Offer price £66.00 Cine VAT) + £1.50 p&p 

(Save over £17-00 on normal BEEBUG price) 


This Basic compiler enables a program written in 
Basic to be compiled into assembly language for 
faster execution and more elTicient use of money. 
Supplied complete with Runtime library. 


Stock Code 0938b 




!' 1 T - ■ p re vious ite ms stiE or 

T. 

1 of 

fer subject to availability: 

Twin 

Offer price £ia95 (ific VAT) + £1.50 p&p 
Stock Code 1083b 

1 

Software Developer's Toolbox 

Offer price £29.95 (inc VAT) + £3-50 p&p 

Stock Cksde 0918d 


































































